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* Author of this memo 

This reference manual consists of two parts. The first (sections 1 
through 6) is intended for those who are either interested in the 
ITS 1.5 time sharing monitor for its own sake or who wish to write 
machine language programs to run under it. Some knowledge of PDP-6 
(or PDP-10) machine language is useful in reading this part. The 
second part (sections 7, 8, and 9) describes three programs that run 
under ITS. The first program (DDT) is a modified machine language 
debugging program that also replaces the "monitor command" level 
(where the user is typing directly at the monitor) present in most 
time-sharing systems. The remaining two (PEEK and LOCK) are a status 
display and a miscellaneous utility program. It should be remembered 
that the McCulloch Laboratory PDP-6 and PDP-10 installation is under¬ 
going continuous software and hardware development which may rapidly 
outdate this manual. 
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0. Introduction 

The reader will iind oelow in section 0.1 a few notes on tne 
notation used in this manual. This is followed in section 0.2 by 
fairly extensive introductory and overview material on the 
Incompatable Time Sharing system monitor (ITS), tne body of the 
information about which appears in sections 1 through 6. Then in 
section 0.3 will be found a brief preview of the information 
appearing in sections 7, 8, and 9 about the three programs DDT, PEEK, 
and LOCK respectively. The first of these is a modified machine 
language debugging program that replaces the monitor comand" level 
(where the user is typing directly at the monitor) present in most 
time sharing systems. The remaining two are of a status display and 
miscellaneous utility nature. These three sections are each fairly 
self-contained as opposed to any particular section of the six on ITS 
which may be highly interdependent with ether ITS sections, finally, 
in section 0.4, appears a summary of tne appendices to tnis manual. 

It should be remembered that the Project MAC, AI Group, PDP-6 
and PDP-10 installation is undergoing continuous software and 
hardware development that may rapidly outdate tnis manual. Please 
direct all corrections, additions or comments to the author at: 
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Donald E. Eastlake III, 

Room 915, 

545 Technology Square, 

Cambridge, Mass. 0213$^ 

0.1 Notation Used in this Manual 

0.1.1 Numbers 

All numbers v/ritten in arabic numerals are octal except as 
follows: (1) those part of a name, such as a type "35" teletype, (2) 
those part of the meta-structure of this manual (a page or section 
number for example}, (3) or those tnat are floating point, which will 
always have more than one digit to the right of the decimal point 
such as 3.14159. For the meaning of numoers which appear to be 
floating point with one digit to the right of the decimal point and 
which are not section numbers, see section 0.1.3 below. Numbers tnat 
are written alphabetically are decimal. 

0.1.2 Character Objects and Strings 

Character objects and strings are usually surrounded by 
quotation marks ( ) and are relatively clear from context. 

Non-graphic characters typea oy nolaing down the control key of a 
teletype ana striding a graphic are representea oy the graphic 
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preceeded by a as in ~A for "control-A". The special character 
alt.-mode (or escape or prefix) is represented by " 

0.1.3 Bit Positions and Intervals 

Bit positions in thirty-six bit words (word length on the PDP-5 
and PDP-10) are represented by the concatenation of a digit from 1 
through 4, a 'V, and a digit from 1 through 9. Tne first digit is a 
quadrant number starting from the right or least arithmetically 
significant part of the word. The second digit is a bit number in 
the quadrant, also starting from the right or least significant bit. 
Thus 1.1 is the lowest bit and 4.9 the sign bit. 

Eit intervals are represented by the concatenation of an 
included starting bit position, a "— *, and an included terminating 

position. Thus 3.3-3.1 is tne lowest octal digit in the left half of 
a word. 

0.1.4 Internal References 


Most internal references in the text of this manual are of tne 
following form: [App xj, [Ref xj, and [Sec x]. These refer, 
respectively, to the x th appendix, the x # th item in the section of 


this manual entitled References', and the x'th numbered 


section of 


this manual. Some internal references are written out in less 
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formality and combined forms are allowed, such as the following, 
whose meaning should be evident: [Sec x, yj, [App x; Ref x, y] , etc. 

0.1.5 Other Conventions 


UUO's ("UnUsed" Operations [Ref lj) that trap to the system [Sec 
1.2.1] to request action by it are frequently rei’ered to as "system 
calls . (This should not be confused with the .CALL subclass of 
system calls.) Individually they are written in all capital letters 
with a preceding period. The reason for tnis is that the MIDAS [Ref 
3] assembler has just these character strings (actually the first six 
characters including the period) pre—defined as symbols. In 
pronouncing them, the period should be ignored. 

The use of the system calls described in this manual is 
frequently illustrated by a short e/erpt of pseudo-asseably-language. 
In such examples, the tag CALL will appear on the line of the system 
call in question. Frequently set-up instructions prece^de the call to 

emphasize certain of its properties. They should not be taken too 
literally. 


0.2 Introduction to lib 


The 

tailored 


Incompatible 
to the Frojec 


Time Snaring system (rib) is a control program 
t MAC Artificial Intelligence (AI) Croup ?D?-5 
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and PDP-10 installation. It was designed in an attempt to provide 
the following potential advantages of a time snaring system: 


(1) More than one person can perform tasks not requiring all 
availaole computer resources with seeming simultaneity; one person 
can similarly perform several tasks. 

(2) Simple device independent input-output facilities snould relieve 
the user of having to worry about hardware interface routines. 

(5) Jobs which would otherwise require excessive continuous blocks of 
time can be performed automatically in small parts over long periods 
of time at reduced priority. 

(4) Various debugging and other facilities can be designed-in using 
the mechanisms necessary to protect user programs from each other. 


To achieve these advantages and the particular goals of Project 
MAG's AI Group, which require a high level of sophisticated service 
to a limited number of users, ITS is designed with the following 
properties: 


(1) ITS sits in control of the PDP-6 performing most input-output for 
and allocating machine resources among various user programs. 

(2) All user programs reside in core storage so it is possible to 
switch between programs with great rapidity and have sufficiently 
short quanta to allow character response without undue inefficiency. 
(Swapping of programs may soon be added but it is. expected that only 
dormant programs.will be swapped out.) A user may have many programs 
running for him simultaneously". 

(3) ITS has a minimal direct user command facility to assure users 
tnat they.can maintain control over their programs. lor the utmost 
in ilexibility almost all system actions are the result of systems 
calls executed by the user's programs. 
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(4) ITS attempts to provide not only simple standardized input-output 
and other system calls hut also much more complex and specialized, 
calls which reduce overhead or enable the use of special devices and 
features. 

MIDAS, a machine language assembler with macro facilities [Ref 
3, 10], was chosen for writing ITS because of the resultant 
efficiency, flexibility, ease in writing, and ease in debugging. For 
information more detailed or more recent than this manual consult the 
sources listed in Appendix F. 

0.2.1 Preview of Section 1 

j.he user of ITS normally commands a hierarchy of programs in 
machine storage organized in an inverted tree. The top procedure 
[Sec 7] is initially loaded for him by the system when he informs it 
of his presence by typing a Z on an idle console [Sec 1.1.1], All 
programs may have inferior procedures which they control. Almost all 
commands to the system are machine instructions [App A, £; Ref 1], 
which trap to the monitor, executed for the user by his programs [Sec 
1.2], The only exception is that he may interrupt the superior 
procedure of the program with which he is conversing by typing ~Z 
[Sec 1.2.1]. By this method the user can return to his top procedure 
at which point Z s typed on his console are ignored by the system. 
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0.2.2 Preview of Sections 2 and 3 

The majority of the code in the ITS monitor is devoted to 

input-output. It has been organized with sucn goals in mind as 

flexibility, speed, and generality. Simple device-independent system 

calls applicable to all devices where they are meaningful, more 

complex byiefficient calls applicable to most devices, and 

specialized system calls enabling nearly full use of some special 

devices are all available. Most devices are referenced symbolically 

[App C] and procedures may cause symbolic translations such that an 

inferior procedure referencing a particular device will in fact get a 

different device. Input—output may be done a character or word per 

system call or, for less overhead per character or word, an arbitrary 

size block of words may be transfered into or out of the user 

program's core with one system call. The user program is not 

required to have any buffers in its core image. Many special 

features relate to consoles or special devices on the PDP-6 such as 
1 

eyes, arms the DEC 340 display. 

0.2.3 Preview of Section 4 

A feature of the ITS monitor not frequently found in time 
sharing systems and contributing greatly to its flexibility and 
generality is that user programs may receive software implemented 
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interrupts in much the same way that ITS receives hardware 
interrupts. The system is so designed that the user is rarely 
involuntarily uninterruptable for more than a few nundred 
microseconds. If the interrupt is dismissed in a normal manner the 
non-interrupt portion of the program can proceed even from the 
middle of a system call taking an arbitrary amount of time. 

The ITS core allocator keeps a record of the status of each 2000 
word block of memory and the 200 word sub-blocks into which some of 
these are divided. It allocates and de—allocates memory for and at 
the request of procedures and system input-output routines. Most of 
its complexity is due to the lack of paging on the PDP-6 which makes 
it sometimes necessary to shuffle memory to provide sufficient 
contiguous space for a procedure. 

A scheduling algorithm is used which tries primarily to equalize 
machine time used by each active procedure tree (console) and 
secondarily to equalize machine time among those procedures in eacn 
tree. The system variables related to a particular procedure [App D] 
used by the scheduler and other parts of ITS are kept in system 
memory and do not impinge on the user's core image. 

0 . 2.4 Preview of Section 5 

user programs operating within the environment provided by ITS 
are organized (as mentioned in section 0.2.2) as inverted tree 
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hierarchies. Superior procedures can retrieve and store words in 
their inferior procedures as if they were input-output devices. 

There also exists a large set of special system calls for controlling 
procedures immediately beneath them and several special ways that 
procedures may communicate with their superior procedure. Buffered 
communication between arbitrary pairs of procedures treating each 
other as input-output devices is also provided [Sec 3.4.3]. 

0.2.5 Preview of Section 6 

A large number of miscellaneous system calls and features exist 
for a variety of purposes. Some provide easy input-output to devices 
which do not fit the forms of standard ITS devices. Others provide 
the use of certain hardware modifications to the PDP-S whicn enable 
the simulation of certain features of manual control of the PBP-5 
such as address stop [Ref l]. The remainder are such minor but 
necessary functions as login and logout. 

A special procedure, known as the system job, exits under ITS. 

It performs various low priority functions for the system and can 
check constant portions of ITS against a copy in an attempt to detect 
some forms of system or hardware failure. 
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0.3 Introduction to DDT, PLLn, and LOG;. 

inese three urograms all run under I To nut are more closely 
related to ii than TiOSt otner systems progrurns. iiie editor (TLCC), 
assembler (MIDAS [lief 3]), list processing language (Lion), etc. used 
by the rroject MAC aI u-roup nave also been modified to run under IIS 
but nave very similar non-time-sharing versions. plSx and LOGS, would 
generally be meaningless outside ITS and while tnere is a 

non—time—snaring DDT, tne version for ITS nas been very extensively 
modified. 


0.3.1 Preview of DDT 


dDi originated as a general macnine language debugging program 
on the Digital equipment Corporation fbp-l computer. „hen tne 
hierarchal organization of procedures [Sec 5] and logical simplicity 
ol procedure origination of almost ail system actions [Sec l.gj had 
been decided upon, the need I or a conversational monitor command 
program was recognized. An extensively modiiied DDt, with commands 
relating to various ITS features and modifications so as to be able 
to control multiple procedures was the ocvious answer, lor Historic 
reasons a top level modified DdT under US is xnown as a *RACiRu\ 



ITS 1.5 Reference Manual 


Page 11 


0.3.2 Preview of PEEK and LOCn 

The first of these utility programs, PEEK, is described in 
section S of this manual. It provides periodically updated displays 
or printouts of various aspects of the time sharing system’s status. 

The second and smaller program, LOCK, is described in section 9 
of this manual. It performs a variety of miscellaneous functions, 
some related to testing or debugging ITS. 

DDT, described in section 7, is the normal means by which the 
user may load and transfer control to these programs. Note that the 
commands P, Q, and ? have the same meaning for both programs. The ? 

command causes each of them to print a list of their commands with 
short explanations. 

0.4 Preview of Appendices 


The first three appendices to this manual are for 
cross-reference and index usage (although important cross-references 
are frequently included in the text [Sec 0.1.4J). Appendices A and B 
list system calls [Sec 0.1.5, 1.2.1] in numeric and alphabetic order, 
respectively, with the number of the manual section most relevant to 
tne call. Appendix C lists symbolicly referenceable input—outnut 
devices in alpnabetic order with the section or sections most 


relevant to them. 
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Appendix D is nearly a direct extract from the source listing of 
ITS. It is the initial dummy image of the user variable area, one 
of which exists for each procedure LSec 4, 5J in a system. 

Appendix E, included for completeness, lists certain system 
calls that are being phased out along with tneir replacements and 
short descriptions of their functions. 

Appendix F lists persons to consult for further information on 


ITS. 


The last appendix, denominated G, gives a single console session 
with ITS as an illustration in which the self documenting features of 
EDT, PEEK, and LOCK are exercised. 
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1. Transmitting Commands to ITS 

See also section C.2.1. 

1.1 Control Z 

The only item of inrut-output data recognized by ITS directly as 
a command is the character ~Z when received from an idle teletype or 
from an active console, that is a teletype in control of a procedure 
tree [Sec 5] • A teletype is a member of the class of devices that 
may be consoles, currently either a GE Latanet 760 terminal or a ilSR 
35/37. Teletypes may also be in use as ordinary devices (as Tnm 
instead of TTY [Sec 3.2.1]) in which case ITS ignores ~Z's typed on 
them. 


1.1.1 Control Z on an Idle Teletype 


If the teletype is idle, Z normally causes the teletype to 
become a console and loads and starts as its top level procedure [Sec 
5.1, 7] the dinar, file named EACTRIl" on device SYS, or if not found 
there from device UT2 (see section 2.1 for a discussion of file and 
device names). The JEAh'E of a thus initiated procedure is ILnCTRR and 


its ITPAMn and STARE are set to the value minus one [Sec 2.^.3 
Am !j . This will not happen if there is insufficient memory 


. i; 


9 
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available or if too many people type ~Z simultaneously. ITS will 
echo a *Z typed on an idle teletype if and only if it succeeded in 
starting a top procedure. If a failure to start a top procedure is 
due to lack of memory, a console free message will be typed out [Sec 
6.5] . 

1.1.2 Control Z on an Active Console 


The effect of Z in the second case, that of an active console, 
is intended to be such that the user at the console may cause control 
of his console to revert to higher level procedures and ultimatly to 
his top level procedure even in the face of hostile inferiors. 


A Z typed on an active console is ignored by ITS if the console 
is being controlled by its top level procedure. Otherwise it sets a 
flag associated with the console so that it may not be assigned 
downward in the procedure tree [Sec 3.2.1.1], This flag is cleared 
only by typing any character other than ~Z on the console. ITS also 


sets the Z interrupt *bit, a class one interrupt [Sec 4.2J, for the 
procedure controlling the console and possibly for an arbitrary 
number of procedures, each the immediate superior of the last, 
extending upward in the tree from the procedure controlling the 
console. ihe condition ior each step upward in the procedure tree is 


that either the superior to the procedure currently having its ~z 


interrupt bit set 


is stopped or the current procedure was found to 
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already have its Z hit on. 

Action on Z interrupt hits set will he taken in less tnan one 
quantum time when the scheduler LSec 4.4J next runs. 

1.2 Trapping Instructions 

With the exception of Z all commands to ITS are given hy 
instructions which trap to the monitor. All valid commands are from 
a class of instructions called UUO's which are characterized hy an 
initial octal digit of 0. These are discussed in section 1.2.1 and 
listed in Appendices A and B. Section 1.2.2 concerns all other 
trapping instructions. It is a useful characteristic of the PDP-5 
and PDP—10 that an identical effective address calculation is 
performed on all words fetched as instructions regardless of their 
operation code or legality [Ref Ij. Thus indexing and indirect 
addressing are availaDle on all trapping instructions. Interrupts to 
the monitor as a result of conditions encountered in the execution of 
an instruction (such as memory protection violation, AH overflow, PDL 
overilow, etc) rather than the type of instruction are discussed in 


section 4.2 
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1.2.1 UUO's 

The execution as instructions or words with an operation code 
[Per l] or from DUD to 077 normally results in the instruction word 
being stored in absolute location 40 modified by having had its 
effective address computed and stored in its address field and its 
indirect and index fields cleared. The instruction in absolute 
location 41 is then executed. Since all ITS system calls utilize 
only UUO's 040 through 047 the Project MAC A1 Group's PUP-6 has been 
modified so that UUO's 001 through 037 and 050 through 077 will trap, 
as described above, but directly to the user program's relocated core 
image with no extra overhead. UUO 000 will also'appear to trap to 
the user but this occurs via monitor simulation that checks to see if 
relocated location 41 directly addresses (indexing or indirect 
addressing ignored) a location between 20 and the location 6 less 
than the top of the user's core image inclusive. If so, a JSR to 
that location is simulated. If not, the user's illegal instruction 
interrupt bit, a class two interrupt [Sec.4.2], is turned on and a 
schedule [Sec 4.4] immediately performed. 

Complete lists of system calls appear in numeric order in 
Appendix A and in alphabetic order in Appendix 5. However, a list 
classified by operation code is included here: 
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UUO Symbol Description 

, 04 R , M 0T Executed for each item or block of data 

[SecTs]' 3,1 betWeen a User proeran > and a symbolic input-output device 

and aerogram Isec 2.2]? d t0 iniUali2e input " outp ut between a device 

value°of their°effective 1 address! ySte '° C&11S fUrther dS °° ded by tne 

045 .CALL A class of system calls further decoded bv thP 
value of their accumulator field. y 6 

nf th^vot. ' TJSET Executed by procedures to examine and set some 

yariables associated with their inferior procedures 

[Sec 5^3.2J. * BREAS ExeCUted by a Procedure to signal its superior 

, . C4d , -STATUS Used to ascertain the status of an input-output 

device, channel, or transfer [Sec 2.5], P 

devicef [Sec 2 “! ^ inpUt -° utput to raad ™ly addressable 


ITS system calls were designed to be numerically rather than 

symbolically decoded to decrease their cumbersomness and increase 
monitor efficiency. 


1.2.2 Non-UUO Trapping Instructions 


The only other trapping instructions are those whose first octal 
digit is 7 and the instruction JEST with the 10 or 4 bit on in its 
accumulator field[Ref 1 ]. The first of these two includes all 
instructions which effect hardware input-output and most of those 
affecting the state of the PDP-6 instruction processor (including 
user/executive mode). In tne second the 10 and 4 bits respectively 
dismiss a hardware interrupt and stop the PL'P-S. The execution of 



ITS 1.5 Reference Manual 


Page 16 


any of these trapping instructions causes an illegal instruction 
interrupt to the user (a class two interrupt [Sec 4.2]) unless the 
user s procedure is in iot—user mode [Sec S.8.3]. The remaining way 
to affect the state of the processor is a JRST' instruction with the 2 
bit on in the accumulator field; however, in user mode this will not 
effect the state of the user, special or iot-user [Sec 6.8.5] modes 
except that it may turn off iot-user mode. 
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user core image input-output is negligible in comparison to any 
significant processing of the data. Using system buffers has the 
following advantages: 


(1) The user may be interrupted, swapped out, moved in core, or 
otherwise molested during an .IOT [Sec 2.3] as it is the software 
transfer of data between system buffers and his core. 

(2) Real input-output transfers may proceed without consideration of 
the state of the user program they are occuring for as they are into 
or out of system controlled memory. 

(3) Higher memory efficiency is obtained due to the dynamic nature of 
major file device buffers. Even for devices with fixed buffers, such 
as the line printer, only one large buffer need exist regardless of 
how many programs that could use the device are in the system. 

(4) User urograms need not concern themselves with the size of 
physical blocks-on devices. 


Some devices do not fit this framework very well and system 
calls relating to them are included in section 6. Miscellaneous 
calls and special features related to particular symbolic devices 
are, however, included under the device in section 3. 

2.2 The .OPEN UUO 


CALL: .OPEN CHNUM,FILNAM 

;error return 
;normal return 

FILNAM: MODE,,(SIXBIT /DEV/) 

SIXBIT /FILNM1/ 
SIXBIT /FILNM2/ 
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Inrut-output on a particular cnannel is initialized ty executing 
a .OPEN. The channel is numerically specified by the accumulator 
field oi the • ur'Et (Clibin the illustration above) and an.y Previous 
transfer of that channel is terminated as if ty a .CLOSE [nee 2.7.1]. 
If the user is interrupted [Sec 4.2] during a .OPEL the cnannel may 
have teen closed and not vet reopened. The effective address of the 
•OPEN should point to the first word of a block of three words in the 
■user's core image which specify a device, node, and file. The second 
two words specify the two file names (FILI141 and YIUUZ in the above 
illustration). As a convention, the file names are usually tnou&ht 
of as up to six left-justified sixtit characters rather than 
thirty-six tit quantities. Some devices ignore the supplied file 
names. Other devices augment the file names ty tne procedure's 
system name as explained in section 2.2.3 below. These properties 
are indicated in the device descriptions in section 3. The first 
word has the three character sixtit device name in its right naif 
(LEV in the above illustration) and the.direction and none in its 
left. Immediatly below are the standard mode tits from this left 


half. 



TC 1 r 


'.ef erencs Ten 


• - 1 




• • 1 r* o u 

»• t ; O Ju r * i »- -. > v-i. » 


T it(s) 'lean in 0 
-.9 91'.: a 

4 .9—3.4 Device dependent but usin. 

3.3 l=>Image .code, 

0=>ASCII node, alias character 
l=>?lock node. 

0=>Unit node. 
l=>Cutput. 

(;=>Input. 


•orn f' non 1 ^ V>o ~ o {’ 

i u . U J ** u U 1 a k_> w j ui • 


o 
, < 2 . 


:.l 


ii* 0 L*. ^ • 


The device and file specified will be altered by entries in tne 
translation table [Sec 2.2.2] rade by eitner the procedure or any of 
its surerior rrocedures. because of this translation and the 
symbolic nature of .OPEN, it is one of the slower ITS system calls. 

If the .OPEN is successful it will skip tne immediately 
following instruction. If not successful it will not snip and will 
set a most recent channel in error" system variable associated with 
the procedure to the channel number on wnich tne .OPEN was attempted. 
The reason for the failure may be ascertained with a .STATUS [Sec 
2.5] or via the ERR device [Sec 3.4.4]. Zero file names are not 
allowed on many devices and attempts to use them will cause the .OPEN 
to fail. Any .OPEN closes rreviously opened devices on that channel 
whether or not the .OPEN is successful. 


2.2.1 Pile Directories 


j0r devices with true file structure a file directory of tne 


.riLn. 


device may be read by trying to input tne file with the name 
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(DIR)". If character node is used, a readable file directory 
terminated by a L and C results. If this pseudo-file is read from 
the DSK, DKn, or Pnm device, only files with tne system name [Sec 

2.2.3] of the reading procedure will be listed. £Otn blocx and unit 
modes are available [Sec 2.3]. Tor non-file devices character input 
of this file name will yield the string "NON-DIRECTORY DEVICE". 
Attempted binary input will fail (the .OPEN will not snip) except for 
the UTn devices [Sec 3.1.2] and the DSK family of devices [Sec 3.1.1, 

3.1.3] where an actual device dependent binary of the directory will 
be read. For the DSK family of devices a pseudo-file "M.E.B. (FILE)” 
is also recognized by the system and yields a list of the system 
names [Sec 2.2.3] for which directories exist on the disk. In 
general files may be written with these pseudo—file names and tnen 
renamed [Sec 2.4] so their contents can be read back. 

In an ITS-produced readable file directory, an by a file 
name indicates that the file is inaccessable. This may be due to the 
fact that it is just then being written or it may have been deleted 
while open for reading and will vanish when closed. 

2.2.2 The Translation Table 


Entries in the translation table may be made or deleted by any 
procedure and have effect only at .OPEN time for the procedure making 
the entry and its inferiors. The entry consists of the following: 
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(1) the UNAME and JNAME of the procedure mailing tne entry, (2) tne 
JNAME of the procedure it is to apply to means all JNAME's), (3) 
whether it is to apply to input, output, or both, (4) whether its 
resultant is to be considered final or oe retranslated, (5) tne from 
device and pair of file names, where w *“s in from positions match any 
device or file name, and (5) the to device and pair of file names, 
where ‘'* 4 ‘s in to positions indicate no substitution. 

At .OPEN time all entries in the table are examined to see if 
the device and file names of tne .OPEN and tne UNAME and JNAME of tne 
procedure executing the .OPEN match them. If so and the procedure 
which made the entry is the same or superior to the procedure 
executing the .OPEN, the substitution for device and file names 
specified by the entry is made and unless prohibited by the entry 
this process is repeated. Should eight successful and sequential 
translations be made the .OPEN will fail leaving a "too many 
translations" indication [Sec 2.5] and no further attempt will be 
made to translate. 

2.2.2.1 The .TRANS UUO 

CALL: .TRANS ilLNAM 

;error return 
;normal return 

PILHAM: MODE,,(SIXLIT /DEV/) 

SIXLIT /IILNM1/ 

SIXBIT /ITLKK2/ 
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This system call is expected to point to a three word block in 
the same manner as a .OPEN [Sec c.Z]. It normally skips and returns 
with the block replaced by its translation (the block pointed to by 
•OPEN is never changed by the execution of the .OPEN). If too many 
levels of translation are required it will not skip and the blocK 
will be unchanged. 


2.2.2.2 The .TRAJiAD UUO 


CALL: 


TBLOCK: 
entry 


.TRAMAD TBLOCK 
;error return 
;normal return 


UlIAME ;UNAME of procedure making & subject to 

JNAME ;JNAME for procedure subject to entry 


ATM10,,DEV1 ;4.9 = 0 => 

;4.9 = 1 => 
;3.2 = l => applies 
;3.1 = 1 => applies 
;DEV'l = from device 
EMU jfrorn file names 
EM 12 

,,DEV2 ;to device 
FK21 ;to file names 
EM22 


retranslate 

atomic, don't retranslate 
to output .OPEN's 
to input .OPEN's 


This system call makes new entries in the translation table. 
All information for the entry is specified oy an eight word blocn 
pointed to by the UUO (TBLOCK in the illustration above). Before 
trying to insert a new entry in the translation table, this system 
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call simulates a .TRAHDL pointing at the same block to eliminate 
redundant entries. If a .TKAHAb is successful in creating an entry 
it skips. If not, because the first entry in tne block is incorrect 
or the translation table is full, it returns without skipping. 

2.2.2.3 The .TRAHDL UUO 

This system call deletes entries in tne translation table and 
normally points at an eight word block identical to the one which was 
used by the corresponding .TRAUAi). See section 2.2.2.2 immediately 
above for the contents of this normal block. It may, if appropriate, 
modify the ATMIO bits of an entry for both input and output to delete 
one or the other. It skips if successful in deleting an entry or 
removing one of the directions to which it applies. If it effects no 
change in the translation table, it returns without skipping. It 
also has a special form where the first word of the block is zero 
(not a possible UIIAMEj. In this case all entries previously made by 
the procedure doing the .TRANDL relating to the JNAME in the second 
word of the block are deleted. This special form always skips and 
does not examine the remaining six words of the block. 
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2.2.3 System 'lames 


In order to distinguish the 
shared devices with common file 
used. This file name is refered 


files of different users of ITS on 
directories a third file name is 
to as a procedure's “system name*' or 


S «AmE• 


In readin, writing, deleting, etc. iiles on the LSK and related 
devices [Sec 3.1.1J and on the core link devices [Sec 3.4.3], ITS 
obtains a third file name from the SkA.IE [App D] associated with the 
procedure. This variable is set, when the procedure is initially 
created, to the common UlvAilE [App i)] of the procedure tree [Sec o.lj 
the procedure is in. This is normally the name the user has logged 
in as [Sec 5.1J so his procedures will initially refer to his files. 
However, a procedure may examine and cnange its own SiiAMh oy means of 
an .SuSm [Sec £.5] and may examine and change the SimAas of any of 
its inferiors with a .USET [Sec 5.2.3], 

ihe system name facility is also used to simulate certain 
pseudo-devices as explained in sections 3.1.3 and 3.4.5. 


2.C) The .IUT UuQ 
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;unit mode 

call: .IOT CriKUM,DATLUC 

;return 


DATLOC: ;place char or word read into or written from 


;block mode 

CALL: .IOT CENUM,PKTR 

PKTR: -LENGTH,,DATLOC jpointer, modified during transfer 

DATLOC: BLOCK LENGTH ;"block read into or written from 

All actual data transfers to or from devices being handled via 
input-output channels are initiated by .IQT's. The accumulator field 
of a .IOT should contain the number of an input-output channel (CHNUM 
in the above illustrations) that has been set up for transfer in a 
particular mode between the procedure and a particular device by a 
successful .OPEN [Sec 2.2]. If the channel has not been .OPEN'ed the 
procedure will receive an input-output channel error interrupt (a 
class two interrupt [Sec 4.2]). Also the number of the channel on 
which the .IOT was attempted will be remembered as the most recent 
erroneous channel for use by the ERR device [Sec 3.4.4]. The 
effective address of a .IOT is used somewhat differently depending on 
whether the channel is open in unit or block mode. 

For unit mode (the first of the two illustrations above) the 
effective address points to a word to be written from or read into. 
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For character 'unit modes the character is right justified and the 
rest of the word is ignored on output and zeroed (except as mentioned 
in section 2.3.1) on input. Some devices, whicn are classified as 
input, use the contents of the effective address as an argument to 
determine what they will store back (see devices IMX, VII), and RVD). 

Block modes always read or write a contiguous block of words. 

The contents of the effective address of the .IOT is interpreted as 
having minus the length of the block in its left half and the address 
of the first word in its right half (see second illustration above). 
Block mode normally treats each word in the block identically to the 
corresponding unit mode except that block character modes pack five 
characters of seven bits per word left adjusted. The block pointer 
word pointed to by the .IOT is advanced as the transfer progresses so 
that if it completes the left half will be zero and the right half 
will point to one greater than the last word processed. If a 
procedure is interrupted out of a block mode .IOT the pointer word 
will reflect the progress of the transfer when it was interrupted. 

Block character input-output from some devices which are 
naturally one character at a time is limited to blocks of length 
77777 words or less and the top three bits of the pointer word are 
used during the transfer as a character count. 

When a .IOT returns to the user without causing an input-output 
channel error, the transfer it requested will have been completed for 
unit mode input or output or block mode output. For block mode 
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in^ut, the count in the winter word v:ill indicate the amount 
transfered which mav he less than tnat requested if an eno of file is 
reached [Sec 2.3.1] . 


2.3.1 The End of File Condition 


ior devices on which tne end ct file while reading condition is 
meaningful it is signaled to tne user in various ways depending on 
tne transfer node. For character devices in the character at a time 
mode a C will he read with the left half of the word read into set 
to minus one. In block character node the last worn will be filled 
out with C s. Usually the rointer word will not have counted out as 
the end of file did not occur on a block boundary, lor word devices, 
the user must normally determine the logical end of file from the 
data being read although physical end of file is detectable in blocs, 
mode by the lack of advancement of the pointer word. On some 
devices, attempts to read beyond an end of file will cause the 
input-output channel to be automatically .CnOSE'ed [Sec 2.7.1] and 
xurther .ICT s will cause input-output cnannel errors (class two 
interrupts [bee 4.2]j. 

When packed characters are being read from a word device tne 
physical block is normally filled out with C's but some older files 
on ^nC tape [Sec 3.1.2] are filled out with the character whose ASCII 
value is 141 ( a ). ihe end of file character for a particular.file 
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can "be determined after the file has been opened by putting the 
number of the input-output channel it is open on in tne accumulator 
specified by an .EOFC. This channel number will be replaced with tne 
end of file character for that channel by the execution of the .EOFC. 
See following illustration: 


MOVEI AC,CHNUM 

CALL: .EOFC AC, jreplaces CIIHUM in AC with eof character 

;return 


2.3.2 The Device Full Condition 

Attempted output on a full file structured device (Uln, DSK) 
results in an input-output channel error (a class two interrupt [Sec 
4.2]) for the outputing procedure. This interrupt will occur for the 
•IOT that failed in such a way that it may be successfully resumed if 
the procedure's interrupt routine or some other procedure deletes 
material from the full device. The channel on which the error 
occured is saved by ITS for the ERR device. 
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2.3.3 Mon-Recoverable Lata Errors 

ITS normally encounters non-recoverable data errors when reading 
into its buffer for the user asynchronously with any UUO's by the 
user. After a fixed number of attempts it accepts tne possibly 
erroneous data which it will later give to the user if he reads far 
enough. It also sets a flag related to the channel so that the next 
•IOT performed on it will rive an input-output channel error 
interrupt. The purpose of this flag is to avoid giving the user a 
channel error interrupt with no indication of which channel it is on. 
The user's program may return to the .ICT and continue reading the 
file after handling the interrupt. 

2.4 The .FEELE UUO 

The system call .FEELS is used for deleting and renaming files. 
It points at a five word block which, for the three types of 
.FEELE's, contain the following: 

CALL: .FEELE FELOCK 

;error return 
;normal return 
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;file delete 
FELOCK: -,,DEV 


FN2 

0 


;device on which to find file 
;names of file to he deleted 

; zero 

;unexamined 


;normal file rename 
FBLOCK: -,,BEV 

mu 

FN12 


mz2 


jdevice on which to find file 
;old file names 

;new file names 


;rename 
FBLOCK: 


of file while open for writing 
- ;unexamined 

0 ;zero 

CHKUM ;channel on which open 

mi ;new file names 

FN2 


An .FBELE on a device that is not truly file structured has no effect 
hut skips as do all successful effective .FBELE's. If a .FBELE does 
not skip the reason for its failure may he determined with a .STATUS 
as though the .FBELE had been a failing .OPEK on channel zero [Sec 
2.5] . 
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2.5 The .STATUS IJUO 

CALL: .STATUS CHNUM,DATLOG 

;return 

DATLOC: ;location status information stored in by call 


The accumulator field of this system call is the number of an 
input-output channel (CHNUM in the above illustration) whose status 
word replaces the contents of the effective address (DATLOC in the 
above illustration) of the UUO. This status word is described in 
detail by the tables below; however, its general composition is as 
follows: the left half relates to the channel and is set by failing 
•OPEK's, failing .FDELE's and input-output channel errors; the right 
half relates to the device, if any, open on the chanbl and the state 

A 

of the transfer between it and the user. 


Bit(s) Meaning 

1.1- 1.6 ITS physical device code (see table below). 

1.7- 1.9 Mode in which device was opened [Sec 2.2]. 

^•1 1 => buffering capacity empty. 

2.2 1 => buffering capacity full. 

2.3-2.9 Device dependent. 

3•1~3•6 Set by failing .OPEN's and .FDELE's. (see table below). 

3.7- 3.9 Set by interpreted display [Sec 3.4.1] input-output 
channel errors (see table below). 

4.1— 4.5 Set by non—display input—output channel errors (see 
table below). 

4.G-4.9 Always zero. 


The folowing is a table of ITS 


device codes (note that the 40 bit 
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indicates that the file names used are significant and the 20 bit 
indicates a software device): 


Code 

Symbol 

Device 

1 

Turn 

Teletype (KSR 35/37). 

2 

Tnm 

GE display and keyboard. 

3 

LPT 

Line printer. 

4 

VID 

Old vidisector (‘‘TVB"). 

5 

DVD 

hew vidisector ( TVC"). 

6 

PLT 

Calcomp Diotter. 

7 

PTP 

Paper tape punch. 

10 

I MX 

Input multiplexor (A-L). 

11 

OMX 

Output multiplexor (D-A). 

12 

PTE 

Paper tape reader. 

13 

DIS 

DEC 340 display. 

14 

IDS 

Interpreted display. 

15 

COD 

Morse code transmitter. 

16 

COD 

Morse code receiver. 

21 

ML 

hull device. 

41 

UTn 

DEC tape. 

43 

DSK 

2311 disks. 

60 

USR 

A not immediately inferior procedure. 

61 

USR 

An inferior procedure. 

62 

CLx 

Core link device. 

63 

— 

The directory device [Sec 2.2.1J. 

64 

USR 

PDP-10 device. 


The following is a list of the codes left by failing .OPEN's and 
.FDELE's: 


Code Reason 

1 Ho such device. 

2 Wrong direction. 

3 Too many translations. 

4 File not found. 

5 Directory full. 

6 Device full. 

7 Device not ready. 

10 Device not available. 
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11 Illegal rile name. 

12 Mode not available. 

12 1iie already exists (attempted rename). 

14 Bad channel number (attempted open rename). 

15 Link depth limit exceeded (DSK). 

Id Pack not mounted (Pnm). 

IV Directory not now available. 

20 User doesn't exist (DSK or USE). 

21 Local device only. 


The following are the error codes left oy the 340 interpretive 
display routines: 


Code Meaning 

1 Illegal scope mode. 

2 Scope hung. 

3 More than 2000 words scope buffer. 

4 Memory protection violation. 

5 Illegal scope operation. 

6 Memory protection violation on ?DL pointer. 

7 Illegal parameter set. 


The following are the non-display input-output channel error code 


Code Meaning 

3 Don-recoverable data error on read [Sec 2.3.3]. 

f Lon—existant sub-device (such as IMX channel LSec 

) • 

5 Over .IuPOP [Sec 2.6.1]. 

6 Over .IOPUSH [Sec 2.6.1J. 

7 Channel does not have a procedure open on it. 

S Channel not open. 

S Device full[Sec 2.3.2]. 
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2.6 The Innut-Output Channel Push Sown Facility 

For greater flexibility in input-output than that available with 
the basic input-output channel system [Sec 2.1], a facility is 
provided whereby a limited number of input-ouput transactions may be 
stored for later resumption. Meanwhile the channel they were being 
effected on may be otherwise utilized. 

2.6.1 The .IOPUSH and .IQPO? UUO's 

CALL: .IOPUSH CRNUM, ;push channel number CRNUM 

;return 

CALL: .IOPOP CHHUM, ;pop channel number CHHUM 

;return 

These instructions treat input-output channels as the PUSn and 
POP instructions [Rei l] do memory locations. A channel may be 
.IOPUSH ed regardless of whether it is open or not and any transfer 
in progress on it will be inaccessable until the slot occupied by the 
information pushed is .IOPOP'ed (possibly by .IuPDL [Sec 2.6.2J) into 
a channel (possibly different from that from which it was 
.IOPUSH'ed). The error status and .ACCESS [Sec 2.7.4] pointer for a 
channel are also correctly stored and restored. Executing a .IOPOP 
into a channel ±irst .CnOSL s the channel. Each procedure's 
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input-output channel push down list [App Dj has space for eight 
entries. 

2.6.2 The .IOPDL UUO 

CALL: .IGPDL ;reset input-output channel pdl 

;return 

This system call takes no arguments and is intended, to reset a 
procedure^ input-output channel push down list. Lntries on a 
procedure's input-output channel push down list actually contain the 
number of the channel that was pushed to produce the entry. This 
information is used only by .IUPDL whose execution is equivalent to 
the number of .IOPOP's [Sec 2.5.1] equal to the number of entries in 
the procedure's input-output push down list and which .IOPOP each 
enty back into the channel from which it was .lOPUSH'ed. 

2.7 Miscellaneous Input-Output Related System Calls 

The folowing system calls relate to most or all devices handled 


via input-output channels. 



CALL: 


; close input-output, cnannel 


.CLOSE CLEiJ-i t 
; return 


mis system call closes the input-output cnannel wnose number 
(ChilUi'i in the above illustration) is in its accumulator field, it 
has no effect if the channel is not open, Executing a .ICT on the 
channel without reooening it will result in an input-output channel 
error. For devices witn true fixe structure it is at close time tnat 
a file with the same name as one being written is deleted. 

2.7.2 The .RESET UUO 

CALL: .RESET ChNIM, ;reset input-output cnannel 

;return 


This system call is intended to reset system buffer pointers so 
tnat buffered data on an input-output channel (specified by tne 
accumulator field as witn CridUrn in the above illustration) will be 
ignored. It is currently implemented for tne following devices: 

Inm, TTi, LPT, PIT, PTK, PIP, xVC, ana jSR. .tor the USE device it 
has special effects [Sec 3.4.^]. 
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2.7.3 The .ITYIC UUO 

MOVEI AC,CK!1UM ;set up for channel number CfiNUM 
CALL: .ITYIC AC, ;get interrupt character 

;error return ;none available 
;normal return ;got one 

It is frequently desirable to examine the characters of an 
incoming stream at the interrupt [Sec 4.2] level of a procedure (for 
’quit' features, etc.). This system call provides the facility to 
read these characters from channels on which devices are open that 
will provide appropriate interrupts (TTY and Tnm). The accumulator 
referred to by an .ITYIC should have an appropriate channel number 
placed in it (see illustration above). Tne execution of an .ITYIC 
will then replace this number with the character read and ship. If 
no character is available the .ITYIC will return without shipping and 
if an improper channel is specified the procedure will receive an 
illegal instruction interrupt. 

2.7.4 The .ACCESS UUO 

CALL: .ACCESS CHNUM,LOC ;set channel pointer to va/Q^/e LOC 

;return 

This system call is intended to be used in accessing randomly 
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addressable devices. A pointer is associated with each input-output 
channel which is set to the effective address of a .ACCESS executed 
with the channel's number (CHNUM in the above illustration) in its 
accumulator field.. This pointer is set to zero whenever the channel 
is closed. Currently this pointer influences only the USR device 
[Sec 3.4.2] but it is hoped that random access will be added to the 
disk [Sec 3.1.1] routines soon. 
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3. Properties of Particular Devices 

Properties and system calls related to particular devices 
handled via input-output channels are discussed below. Lower case 
letters in a device name indicate that there are several devices 
distinguished by numeric digits in their place. The phrase "all 
standard modes" in descriptions below implies that all combinations 
of ASCII/image and unit/block modes are available and that ASCII mode 
implies seven bit ASCII characters and image mode thirty-six bit 
binary words. 

3.1 Pile Structured Devices 

3.1.1 The DSK, DKn, and Pnm Devices 


These symbolic devices represent IBM 2311 units attached to the 
PDP-6. These disks are characterized by interchangeable disk packs. 

A single logical directory is maintained by the system for the entire 
disk volume. Files are identified by two file names [Sec 2.2] and a 
system name [Sec 2.2.3]. If a file is being read, which of the above 
symbolic device names is used is entirely immaterial. There are some 
special aspects to reading directories from th^* devices as explained 

A 

in section 2.2.1. 


If a file is being written, 


the DSK device will physically write 



113 1 


rage 4.0 


.0 helerence Uanuai 


it on a particular drive whose number is assemble! into the system. 

In contrast tne bKn levies will write the file on the n'th drive. 

Tne ?nm device win try to write on a rack v/itn a particular 
two digit number. 

The actual directory lor tnese devices consists of a master 
directory for each drive ana a user directory for eacn system name 
that has teen used to write files on the disk. The maximum number of 
user directories is one hundred. The maximum number of files per 
user is not fixed as the area in a users directory, used to describe 
tne location of tne blocks each fne consists of is dynamically 
allocated, when as is occasionally necessary a garbage collection, 
to compact tne information in a user directory, occurs, the system 
job [bee o.toj prints out a message on its teletype, inis warning was 
added when tne garbage collector was less reliable than it now is. 

Tne master directory for a drive is reaa in tne first time tne 
drive is referenced. A copy is written back out whenever tne disks 
are idle and the master directory has teen changed since it was last 
written out. User directories are read in wnen first referenced. If 
a currently nonexistent user directory is rererencea to write it will 
be created. If reierenced to read, a special- open lose C bec d.oj 
wm indicate this to the user. User directories a: copied out 
whenever the disks are idle and they nave been changed since last 
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copied out. A user directory in memory may be erased if no files are 
open in it, a current copy has Deen written out, and a core request 
provokes the core allocator [Sec 4.3] to examine the status of an 
area of memory including the buffer. 

The IBM 2311 interface transfers information directly to memory 
in units of 2000 words. Dyr^glically allocated buffers in system 
memory are used for input and output. The capacity of each pack is 
about thirty times that of a reel of DEC tape [Sec 3.1.2]. 

3.1.1.1 Links 


CALL: .FDELE EBLOCK 

;error return 
;normal return 

FBLOCK: 200000,,[SIXBIT /DSK/] 

SIXBIT /EEHAM1/ 

SIXBIT /FFNAM2/ 

SIXBIT /T3TNAM1/ 

SIXBIT /TFHAM2/ 

SIXBIT /TSNAME/ 


A speical feature of the disk device is that users may establisn 
symbolic links. If the call illustrated above has been executed, 
then an attempt to read the file FFNAM1 EFKAM2 with the system name 
[Sec 2.2.3] that was being used by the procedure that established the 
link will actually refer to file TEN AMI TF1IAM2 with the system name 
n. A link may refer to another link and so on for up to eight 
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levels. Attempting to write or delete through a lira; writes on top 
of or deletes the link rather that the file it refers to. 

3.1.2 The UTn Devices 

The devices UT1, UT2, UT3 and UT4 represent the four DEC tape 
drives on the PDP-S. They are true file structured devices under ITS 
with all standard modes available. Data is dynamically buffered by 
ITS for both input emd output. The file directory of a tape is read 
in oy the system and retained when a drive is referenced and there is 
no directory being retained for it. An updated directory will be 
written out on a particular tape whenever the directory has been 
changed, no files are open on the tape, and no data transfers are in 
progress on any drive. Files on UTn do not have a system name [Sec 
2.2.3] associated with them. Directories can be excised from core 
only by the .UDISMT DUO. 

3.1.2.1 The .UDISMT UUO 

MOVEI AC,TAPEN 
CALL: .UDISMT AC, 

;error return 
jnormal return 


This system call, if successful, causes a DEC tape's file 
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directory to be excised from core and the tape to be physically 
demounted. The drive number must be in tne accumulator specified by 
the UUO. Manually removing tapes or switching drive numbers of 
drives for which ITS is retaining a directory may result in out-of- 
date file directories left on tapes and directories for one tape 
being written on another. 

A .UDISMT skips if and only if successful. It will fail if any 
files are open on the tape. If a file is opened, deleted, or renamed 
on a tape while the tape is being dismounted by ITS the dismount will 
be aborted and the tape retained. 

3.1.2.2 The .ASSIGN and .DESIGH UUG's 

MOVEI AC,TAPEN 
CALL: .ASSIGN AC, 

;error return 
;normal return 

MOVEI AC,TAPER 
CALL: .DESIGN AC, 

;error return 
;normal return 

These system calls are to enable a user to protect against other 
users accidently referencing his DEC tape to write or delete a file 
or rename [pec 3.1.2.4] the tape. Loth specify tne drive numbers as 
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the contents of their specified accumulator. The .ASSIGN Uu'O s.iips 
if successful and results in attempts to write on the designated 
drive failing unless the writing procedure has the same system name 
[Sec 2.2.3] as the UNAMh of the procedure that executed the .ASSIGN, 
lor a procedure in a disowned tree [Sec 5.2.2], an .ASSIGN will be 
treated as an illegal instruction. An .ASSIGN will fail only if the 
drive is already assigned. The .DESIGN UUO skips if successful and 
causes the drive to be unassigned. It fails if the drive is already 
unassigned or assigned to a different user. A drive may also be 
.DESIGN'ed by a .UDISMT [Sec 3.1.2.1] and the .ASSIGN'ing of a drive 
does not protect against other users dismounting it. 

3.1.2.3 The .UBLAT UUO 

MOVEI AC,TAPER 
CALL: .UBLAT AC, 

;error return 
;normal return 

This system call is intended for reading non-MAC format [Ref 4] 
(such as DEC format) DEC tapes. The contents of the specified 
accumulator must be a drive number for which-ITS is not retaining a 
directory. If a directory is already being retained, tne .UBLAT will 
fail and return without skipping. (The user might try first 
.UDISMT'ing the drive.) 
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If successful, the .UnLAT skips. Instead of attempting to read 
in the directory from the tape mounted on tne specified drive, ITS 
internally marks the drive so that its contents may not he changed 
(no writes, aeletes, or renames). At this point a successful .QPlN 
of the tape may he executed with any file name and all blocks of tne 
tape will he read consecutively. Thus the tape may only he 
referenced to read the file containing the entire contents or to 
•UDISMT [Sec 3.1.1] it. 

3.1.2.4 The .UTUAM UUO 

MOTE AC,[(SIXBIT /111/),,TAPEN] 

CALL: .UTNAi-i AC, 

;error return 
;normal return 

This system call changes the three cnaracter tape name of a 
particular DEC tape. The tape drive number must he specified in tne 
right half of the specified accumulator. The call will fail and 
return without shipping if tnere is no such drive or is tne drive is 
in .U3LAT mode [Sec 3.1.2.3] or .ASSIGn ed [Sec 5.1.2.2] to another 
user. Otherwise it modifies the tapes directory (reading it in if 
necessary) so as to have a tape name corresponding to tne left half 
oi tne accumulator specified oy the caii and skips on return. 
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3.1.2.5 The .UIIHT UUO 


MOVE AC,TAPER 
CALL: .UIHIT AC, 

;error return 
;normal return 


This system call initializes the directory for the DEC tape on 
the drive whose number is the contents of the accumulator it 
specifies. The tape must have been .ASSI&N'ed [Sec 3.1.2.2] to the 
user doing the .U1NIT. If successful the .UiiUT slaps on returning. 
If the specified drive is nonexistent or the tape on it not 
.ASSIGN ed to the user doing the .UINIT, it returns without shipping. 

3.1.3 The COM and SYS Devices 

The device SYS is used for storage of systems programs and the 
message of the day [Sec 7.1.1]. It is currently those files on 
device rSK with system name SYS. Reading or writing device SYS 
causes one to reference uSK as though one’s system name were 
momentarily SYS. The device COM is used for commonly used user files 
and the mail teature [bee 7.2.1, 7.2.2]. In a manner similar to 
device SYS it is DSn with system name COMMON. 
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3.2.1 The Tnm and TTY Devices 


Device TOO is the console teletype. Devices Til through 114 
(the two digits are treated as an octal number) are GE Datanet 760 
terminals with a character only display and keyboard. Devices T01 


through T10 are available for more teletype and teietype-lihe 
hardware and are read and written through the Knight Teletype Kludge. 
Device TTY for a particular procedure is the console coniroling tne 
procedure tree it is in. All input-output to these devices is in 


ASCII characters and the "image" mode [Sec 2.2] has special meanings. 
Further detail on which Tnm is "where" is given in the following 


table (as of July 14, 1963): 


Tnm Location 

TO Main console (by PDP-6). 

T1 Advanced Demote Display Station. 

T2 Outside line (or 1479 depending on switch). 

T3 Robot console. 

T4 PDP-10 console. 

T5 System console (by line printer). 

To Inside line 1425. 

T7 Inside line 1474 (or outside depending on switch) loeps. 


T10 

Spare. 

- 

Til 

GE console by 

plotter. 

T12 

GE console on 

8th floor. 

T13 

GE console by 

air conditioners. 

T14 

GE console by 

ham rig (in far corner). 

T15up 

Nonexistent. 
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A procedure may not open its console by refering to it as Tnra 
for the corresponding n and m. Only one procedure at a time may have 
a ueietype open as a device rather than a consols. Tne procedure 
with TOO opened as a console (TTY) and that actually has control* of 
it [Sec 3.P.1.1] can always seize the DEC 340 display USec 3.4.1], 
Image mode output to KSR 35/37's is very straight forward and 
just sends the character to the teletype unmodified. ASCII mode 
differs only in the following: (1) the character whose value is 33 is 
printed as a "$ (P) other characters with a value less than 40 that 

are not format eilectors or Dell are printed as a followed Dy tne 
character with an ASCII value 100 greater; (3) tab is simulated with 
spaces; (4) the delete character doesn t type out and (5) new line 
is simulated for a carriage return. Output to OE terminals is the 
same as ASCII mode output to KSK 35/37's except for the following: 


(1) all line feeds (IP) are ignored, (P) a "l (form feed) clears the 
screen, (3) an automatic new line is inserted if tne right margin is 
touched, (4) an V‘, as displayed by the CE terminal, is used instead 
ot a preiix, (5) output oeyond tne bottom of the output area 
wraps around and overwrites from tne top of the output area which 
does not include tne bottom three lines unless the first input .OPEN 
[Sec P.J nad the 3.4 mode bit on, (o) finally, if the output is in 
image mode only, the character T will allow overwritting starting 
from the top of the output area without clearing the screen or 
v,Tapping off the bottom. Por all tne above output modes, adding 
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block mode only affects individual character processing by causing 
~C's that are output to be ignored. 

Innut to keyboards (which are all full duplex) is buffered by 
ITS in relatively small fixed size buffers. Striking a key when tnis 
input buffer is full results only in a G (bell) (or ? on a GE 
terminal) being output as echo. Any input when the keyboard is not 
in use, except ~Z [Sec 1.1.1], is ignored by ITS. Procedures may 
enable interrupts (class three) due to non-empty input buffers [Sec 
4.2J and also examine the input characters at interrupt time with 
.ITYIC [Sec 2.7.3]. 

Image mode input is characterized by no ITS-supplied echo and no 
modification of the character codes unless open mode [Sec 2.2] bit 
3.5 ("old mode") is also on, in which case lower case KSE 37 
characters are transformed to upper case KSR 35 characters. 

ASCII mode input provides echo in approximately the same manner 
as outputing the characters in ASCII mode. Procedure output has 
higher priority than echo output. On GE terminals input is normally 
echoed in the bottom three lines unless the 3.4 open mode bit was on, 
in which case characters are echoed where output is appearing except 
that a few characters are not echoed at all. In ASCII mode input, 
the characters whose values are 175 and 176 are input and echoed as 
if they were the character whose value is 33. Having open mode bit 
3.5 on has the same effect for ASCII mode input as it did for image 
mode input. In general, all of the various mode bits affecting input 
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are obtained from the first input .OPEN [Sec 2.2] executed by a 
procedure for a Particular teletype. Tor all the above input modes, 
adding block mode results in input until the block input pointer runs 
out or until a ~C is typed at which point the .IQT [Sec 2.3] being 
executed terminates as on an end of file [Sec 2.3.2]. 

Any input or output TTY .OPEN by a procedure that nas never had 
control of a console will fail. Any input or output .IOT or .OPEN 
executed on a TTY device by a procedure that has had control of the 
device while it is actually being controlled by another procedure 
[Sec 3.5.1] will hang until the executing procedure regains the 
device. 

The device dependent .STA.TUS [Sec 2.5] bits for the teletype 
devices are as follows: 


Sit Meaning 

2.3 Channel open in "DDT mode" (3.4 mode bit). 

2.4 A console (TTY device) open on this cnannel. 

2.5-2.9 If channel open for output: 

Current line number if a GE console. 

2.5-2.9 If channel open for input: 

2.5 Indicates some characters have been seen at interrupt 

and not main program level. 

2.8 Teletype is at the 340 [Sec 3.4.1] or a 340 slave. 

2.9 Teletype is local, not dial in. 


3.2.1.1 The .ATTY and .DTTY UUO's 
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CALL: .ATTY CHRUM, 

;error return 
;normal return 


CALL: .LTTY CHNUM, 

;error return 
;normal return 


These system calls enable procedures in a single console 
controlled procedure tree to transfer control of their console 
between each other. The execution of either by a procedure that does 
not have control of the console, because it was taken away by a 
higher procedure's execution of a .LTTY, will hang until it regains 
control. The accumulator field of each must specify a channel (CRHUM 
in the above illustration) on which an immediate inferior procedure 
is open [Sec 3.4.2]. An .ATTY win pass control of tne console to 
this open procedure unless the procedure executing the .ATTY has 
control of the teletype by taking it from some deeper inferior along 
the same procedure tree branch in which case it reverts to the 
procedure from which it came. An .ATTY will hang instead of doing 
the above if the last character typed on the console was a ~Z. A 

.LTTY retreives control of the console from some inferior to the 
procedure executing it. 


^oth of these calls skip if successful. An .ATTY will fail to 
skip only if no inferior is open on the channel it specifies. A 
.LTTY .vill fail to skip if no inferior is open on the channel it 


4 
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specifies or if the rrocedure executing, it never had control of tne 
console or never gave control away. All other conditions blocking 
the success of either system call cause them to hang. 

3.2.1.2 The .LISTEN UUO 

CALL: .LISTEN AC, 

;return 

This system call is usable only on the console a procedure is 
associated with. It will hang if control of the console [Sec 
3.2.1.1] has been taken away from the procedure executing it and if 
all procedure output has not been typed. It tnen returns with the 
number of buffered input characters in the specified accumulator. If 
the procedure has never had control of the console or is in a 
disowned tree [Sec 5.2.2] zero will be returned. 

3.2.1.3 The Dial feature 

A feature is available under ITS that allows procedures to dial 
calls on the two dataphone lines now available. Caution snould be 
exercised in using this feature if one is using the system over one 
of these lines. The computer may ’’hang-up" in a more literal sense 
than usual. 



ITS 1.5 reference Manual 


Pa§e 56 


CALL: 


:l?uf: 


■iCVE AC, [440600+DIALH, ,DLFJF] 
.DIAL AC, 

;error return 
;normal return 

010201,,020202 

100506,,101000 


The .DIAL call is used to initially associate a procedure with 
dialer and to actually request dialing on the dataphone line 
associated with the dialer. The accumulator specified 'ey the call, 
AC in the above example, should contain a byte pointer directly 
addressing a byte within the users core image. Indirect addressing 
and indexing are ignored and in fact the index field is used to 
specify the dialer number, DIALM in the above example. This 
corresponds to a teletype as follows: 


Dialer Teletype 
0 T07 


T05 


The .DIAL will have no effect and return without skipping if any o 
the following conditions hold: (1) a nonexistant dialer is 
specified, (2) the teletype associated with the dialer is in use b: 
procedure other than the dialing procedure, or (3) the associated 
teletype is not in use tut the dialer is assigned (by the sxecutior 
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of » .DIAL not vet followed by a .HANGUP (see below)) 10 a procedure 
other than the dialing -procedure. If the .DIAL skips in returning it 
will have set up variables in the system so that dialing will proceed 
asynchronously with the procedure^ execution. The byte string, which 
specifies what is to be dialed, can not be more than five worus long. 
These words are transfered to the system by the .DIAL and dialing 
will be unaffected by the user£ subsequent modification of his image 
of these words. However a later .DIAL without an intervening .DIALW 
or .HANGUP (see below) will simply overwrite these words and may 
cause garbled dialing. 

As dialing proceeds, each byte is examined in succession. A 
zero byte indicates the end of bytes to be processed. A byte whose 
value is between one and ten causes a similar number of dial pulses 
to be sent. Interdigital pauses are automatically inserted after 
each digit. Bytes with a value larger than ten cause a pause in 
dialing of as many tenths of a second as the bytes value minus ten. 

A special means is provided to send the "break*" signal. If the 
accumulator specified by a .DIAL is zero except possibly for the 
index field (where the dialer number is specified), then a "break*’ 
will be sent after a-.DIALW has been simulated to avoid garbling any 
dialing in progress. 
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CALL: .DIAL 1 ;/ DIALM, 

;error return 
;normal return 

This call refers to the dialer specified by its accumulator 
field (DIALM in the above example). It nas no effect and returns 
without skipping if the dialer has not been assigned to the 
.DIALW'ing procedure by a successful .DIAL (see above). Otherwise it 
returns and skips after requested dialing by the dialer is complete. 

CALL: .HANGUP DIALS, 

;error return 
;normal return 

ihis call re±ers to the dialer specified by its accumulator 
field (DIALS, in the above example). It has no effect and returns 
without skipping if the dialer has not been assigned to the 
.HANGUP'ing procedure by a successful .DIAL (see above). Otherwise 
it returns and skips after hanging up the line for at least three 

seconds and freeing the dialer so it is no longer assigned to any 
procedure. 

3.2.2 The LPT Device 


A six hundred line per minute Data Products, Inc. line printer 
with one hundred and twenty print positions and sixty four printin' 
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characters is available for character output as device LPT. The 
ASCIl/image mode bit [Sec 2.2] is ignored in .OPEN's on device LPT 
but either single ASCII characters or blocks of packed characters may 
be output as indicated by the Dlock/unit mode bit. The following 
’’transformations are made to the output text: (1) lower case 
characters are made upper case, (2) characters beyond tne one 
hundred and twentieth mint postion are ignored, (o) format effectors 
(except for vertical tab) are simulated as for a model 55 teletype, 
thus overprinting can be accomplished by using carriage return 
without line feed, (4) characters with an ASCII value below 40 other 
than the simulated format effectors and character 33, which is 
printed as a are printed as a followed by the character 
whose ASCII value is 100 greater. 

Only one procedure may have the LPT device open at one time but 
it may oe open on more than one channel. Procedures in disowned 
trees are blocked from opening the LPT device but it will not be 
taken away from a procedure as the procedure is disowned [Sec 5.2.2]. 
(Disowned procedures may use the TPL [Sec 3.4.5] device.) A fixed 
1000 word Duffer in ITS is used for output to this device. 


The device dependent .STATUS [Sec 
have in the 2.2—2.9 field the current 


3.5] bits for the LPT device 
character position in tne print 


1 ine. 


-his count starts at zero at the left margin. 
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3.2.3 The PLT Lev ice 

A CalComp model 565 plotter [Ref 9] is available via “character" 
output to device PLT. Availaole v/itn tne same modal restrictions as 
the LPT device [Sec 3.2.2], it is also similar to that device in tnat 
it may only be open by one procedure at a time but may be open on 
more than one channel. A fixed 200 word area is used in ITS to 
buffer output. 

Only the right most six bits of characters output to tne PLT 
device nave effect. They are as follows: 

Bit Effect if a one 

1.1 drum down 

1.2 drum up 

1.3 carriage right 

1.4 carriage left 

1.5 pen up 

1.6 pen down 

3.2.4 The PTP and PTR Device 

The PTP and PTR devices represent, respectively, the sixty three 
and a third character per second paper tape punch and four hundred 
character per second photoelectric paper tape reader on the PLP—6 
[Ref 1], They are similar to the LPT and PLT devices [Sec 3.2.2, 
o.2.J) in tnat only one procedure may have each open at one time but 
tha*„ procedure may have the device open on more than one channel 
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uossibly in different modes. Also output or input is buffered in ITS 
in fixed areas of 2u and luu words respectively. These devices 
differ from the LPT and PLT devices in tnat ail standard modes LSec 
4J are available and the following special mode. If in a successful 
.OPEN for one of these devices, the 3.4 mode bit [Sec 2.2] is on tnen 
the 3.3 mode bit is ignored, the 3.2 mode bit must indicate unit 
mode, and all eight paper tape channels may be written or read from 
or into the eight rightmost bits of the word addressed by each .IGT 
[Sec 2.3] executed. 

3.2.4.1 The .FEED UUO 


CAlLi .FEED CHilUM, 

;error return 
;normal return 

This system call checks to see if the PIP device is open on the 
channel it specifies (CHhUM above). If not, it returns without 

skipping. If so, it causes one line of blank tape to be punched and 
skips. 


- 3.2.5 The COD Device 


'unit 


This is a character output device that may be 
mode but not any form of image mode and not 


used in block or 
by more than one 
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procedure at a tine. It causes transmission of low power ill Morse 
code at a frequency just off tne bottom of tne FM broadcast band. 
Cnaracters for which there is no standard Morse code (such as line 
feed) are ignored except that the speed is set by cnaracters whose 
value is greater than 167 to approximately, seventy five divided by 
the difference between the character value and 167, words per minute. 
It tries to interrupt on the input-output channel it is open on when 
the fixed buffer in ITS it uses is almost empty. 

3.3 Robotics Oriented Devices 

3.3.1 The UVD, TVC, and V1D Devices 

The FID and NVD devices are somewhat similar to the IMX device 
[Sec 3.9] in that they may be open by any number of procedures, have 
bloch and unit modes, and '"functional" word input where the quantity 
read is a function of the contents. They differ in that the 
ASCII/image .OPEN mode bit [Sec 2.2] is ignored and they represent 
vidissectors. The initial contents of words input into should be the 
coordinates of a point in the field of view of the particular 
vidissector at which it is desired to know tne light intensity. This 
contents will oe replaced oy a function of said intensity. The exact 
form of these words and tne use of any device dependent .OPEN mode 
bits [Sec 2.2J is listed in the table below. 
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VID KVD 

c.o-1.1 4.5—3.2 

4.3-3.1 2.5-1.2 

1.8—1.1 (reciprocal of intensity) 

4.9-3.3 (normalized floating reciprocal 

2.1-1.1 (integer logarithm reciprocal 

400 3.1 (overflow) 

3.2 (dim cut off) 

-1 4000000 

3.5-3.4 (340 intensity) 

3.5-3.4 (confidence level) 

3.8-3.6 (dim cut off level) 

The VID device is of little use as it is a lower quality subset 
of the RVD device. The deflection signals for the VID device come 
from the uEC 340 display [Sec 3.4.1] whose use will be degraded by 
using device VID. 

The TVC device is the same as the :IVD device except tnat it 
should be opened on two channels, one for output and one for input. 
V.ords with coordinates in them are output on one channel and stored 
in a fixed length buffer in system memory. There they are replaced 
by ITS, at its interrupt levels with the response word shown above 
(value). They may be read, in the same order as output, on the input 
channel. Unlike most devices, a block mode .IOT outputting to the 
iVC device when its bufier is full will not hang up but return with 
the block .IOT pointer word pointing at the first word not 


I tern 

X 

Y 

value 

intensity) 

intensity) 
(too 
dark) 
dead 

modes 
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transfered. 


3.3.1.1 The .VSCAN and .V3TST UNO's 


(Some of this section is taken from Reference 13.) 


CALL: 


PTABLE: 


ARRAY: 


.VSCAN PTABLE 


;return 


WBIT,,VC0N0 

;+0 

-LENGTH,.ARRAY 

;+l 

XRES,,YRES 

;+2 

R1 

;+3 

R2 

;+4 

Cl 

;+5 

R3 

;+6 

R4 

;+7 

C2 

; +10 

PI 

;+ll 

P2 

;+12 

BLOCK LENGTH 



ihis system call allows the user to read the light intensity at 
an array of points with low overhead and, if desired, overlapped 
computation. 

The effective address of a .VSCAN should point at an eleven word 
Block of parameters defining the points to be scanned, the locations 
to be read into, the mode they are to be read in, and wheither the 
call should hang until the scan is through. The effect of the 
parameters, in order, is described below. 
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The first word has in its right half the control bits for the 
vidisector as in section 3.3.1 for NVD. The sign bit, if a one, 
causes the .75CAN to hang until the scan is over. If a zero, 
computation by the .VSCAN'ing user may procede while the scanning 
procedes at ITS's interrupt level. 

The second word should be similar to a block mode .IOT [Sec 2.3] 
pointer word. Its right half should point to the beginning of an 
array to be read into in the response format of MVD in section 3.3.1. 
Its left half should be a negative count equal to or larger, in 
magnitude, than the number of points being scanned. (If in the above 
illustration either PTABLE+12 or ARRAY+LENGTH-1 were beyond the users 
memory bound, the .VSCAF would be treated as an illegal instruction.) 

The third word has in its left and right halves, as eighteen bit 
integers, the X and Y resolution or number of points to be 
scanned in each direction. 

The remaining nine parameters, which are fixed point quantities 
with the binary point between bits 2.9 and 3.1, define where the ARES 
by YRSS points lie in vidissector coordinates according to the 
following ALGOL program: 

FOR Yl<-0 STEP 1 UNTIL YRES-1 DO- 
BEGIN 

Y2<—(2*Y1+1)/(2*YRES) 

FOR Xl<—0 STEP 1 UNTIL XRSS-1 LO 
BEGIN 

X2<-(2*X1+1)/(2*XRES) 

TEM?<—P1*X2+P2*Y2+1 
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X<-(K1*X2+R2*Y2+C1)/T2MP 
Y<-(R3*X2+R4*Y2+C2)/TEMP 
ARRAY(Y1*XR2S+X1)<-SCAN(X,Y) 

END 

END 


A .VSCAN will hang up until the IIVD device is free. This device 
is then seized, not to be released until the scan is over or aborted. 
A scan is only aborted if the procedure it is being executed for is 
reset [Sec 3.4.2] or its core size reduced so as to exclude the array 
being read into (ARRAY in the above illustration) or by .VSTST. 


MOVSI AC,1 ;or 0 or 400000 

CALL: .VSTST AC, 

;return 


This system call allows later control of and sensing by a 
procedure that has overlapped computation with a .VSCAN. It is 
illegal if executed when another procedure is .VSCAN'ing. If the 
contents of the specified accumulator is positive, the .VSTST hangs 
till the scan is over. If the contents of the specified accumulator 


is negative, any scan in 
specified accumulator is 
into by the scan, if any, 


progress is aborted. If the contents of the 

zero, the user's location then being stored 
replaces it. 
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The OMX Device 


A multiplexed digital to analog converter on the Pi/P-Ci is 
available via word output uo tne OMX device [itef 5, gj . block and 
unit modes are available and the ASCII/image" mode bit [Sec 2.2] nas 
a special significance explained below. Each word output should have 
the desired channel number in bits 4.9-4.4 and the value to be 
converted in bits 4.3—3.1. ihus cnannel numbers range from zero to 
f7 and values from zero to 7777. These output channels decay 
exponentially with some large time constant so ITS stores the current 
desired T ^alue for each channel and outputs them every half second as 
long as the OMX device is open by some procedure. Output in "ASCII" 
mode immediately affects the channel as well as storing a value to be 
output periodically. Slightly less overhead occurs in "image" mode 
which only stores a value in ITS and may nave no effect for ut to 
half a second. Any number of users may have the OMX device open, 
possibly on more than one channel and possibly in different modes. 
Current OMX channel assignments are as follows: 


Channel 

Effect 

0-31 

Unused. 

32 

UVD iris. 

33 

UVD focus. 

'Z A 

“X 

UVD mirror. 


Unused. 


TVS ran. 

37 

TVS tilt. 

50 

MAS hand extend. 
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51 MA3 hand, rotate. 

62 MA3 hand rrasp. 

u 6 uannon lens zoom (MA3 iiand finner -1). 

54 Cannon lens foeus (MA3 hand finrer ;/d). 

65 ,«iA3 hand tilt. 

66 Alles hand **rip. 

67 Alles hand tilt. 

70 Alles hand extend. 

71 Alles hand rotate. 

72 AMF arm wrist roll. 

73 AMi* arm wrist yaw. 

74 TDR horizontal. 

75 AMF arm horizontal. 

76 AMF arm vertical. 

77 AMF arm swine. 


3.3.2.1 The .ARMOVE and .ARMOFF UUO's 


(Some of tnis section is taken from Reference 13.) 


M07E AC, [-LENGTH,,ARMBLX] 
CALL: .AEMOVE AC, 

;normal return 

;test successful return 

ARMELK: FLOCK LENGTH 


This system call allows one procedure at at time to exercise 
special control over several digital to analog multiplexor channels 
[isc 3.3.2]. It provides acceleration and velocity limiting, 

software limit stops, and conversion from joint number lo multiplexor 
channel. 


To avoid certain timing problems, the transmit 


on of connanis to 


4 
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the multiplexor control routines in ITS is noninterruptable (but for 
a limited length of time as only a limited number of commands mav be 


transmitted). Each command is a single word 
the contents of the accumulator specified in 
these words is as follows: 


Bits 

Significance 

4.9-4.4 

joint number 

4.3-3.7 

command 


unused 

uJ • kD 

indirect 

3.4-3.1 

index 

2.3-1.1 

address or operand 


.locx 


tne call. 


pointed at by 
Trie format of 


ihe currently availaDle joint addresses are as follows: 


Address Significance 
0 AMT swing 

1 AMF vertical 

2 AMP horizontal 

3 AMF yaw (inoperative) 

4 Alias hand tilt 

5 Aides hand grip 

o Aides nand rotate 

? Aides hand extend 

10 AMF roll (inoperative) 


currently available commands are as follows: 
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Command 

Sign 

ificance 


n 

u 

set 

destination 


i 

set 

velocity limit 



tes t 

magnitude of 

position 

'7 

tes t 

magnitude of 

velocity 


The operand, is computed by addins the contents of trie specified 
index register (if any) to the right naif of the command. Tne result 
is masked to 13 bits. If the indirect bit is a one, trie right naif 

of the word addressed is used as the operand, ho further indexing or 
indirecting is interpreted. 

The test commands are "true" if the quantity tested exceeds the 
operand. If any tests are "true" the .AMOVE will snip. 


CALL: . AriiTOi: F 

;return 


The multiplexor control routines are activated by the first 


.ARMCvE and are turned off by an .ARMOFF or killing the .ARi 


procedure. 

An .AMOVE is illegal 
(2) the block extends above 
reference is out of bounds, 
number is specified, or (5) 


if (1) the arm is in use by another user, 
the user's memory bound, (3) ant indirec 
(4) an unused command code or joint 
the clock is over 100 words long. 


t 
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3.3.3 The IMA Device 


A multiplexed, analog to digital converter attached to the PDP-S 
is available via word input from the IMA device [Ref 5, G]. Bloch 


and unit modes are available but the "ASCII/image" mode bit [Sec 2.2J 
has a special significance explained below. Bach word input into 
must initially contain a number from zero to 177. This number will 
be replaced with the twelve bit digitalization of tne analog quantity 
associated with the multiple^cnannel of the same number. If it is 
desired to read in values converted at eacn .101 [Sec A.4] time tnen 
device IMA should be opened in ASCII mode. Opening device IMA in 
image mode causes ITS to continuously read all input multiplexor 


channels into system core a minimum of about ten times a second. 
Executing a .IOT on a channel opened in this manner will result in 


values up to one tenth of a second old but without the overhead 
necessary to read in new values. Any number of procedures may have 
the IMX device open, possibly on different channels and possibly in 
different modes. Current IMX channel assignments are as follows? 


Channel Input function 

C-21 Unused. 

42 MA3 hand extend. 

23 MA3 hand rotate. 

24 MA3 hand grasp. 

25 cannon lens zoom (MA3 hand finger jfl). 

26 Cannon lens focus (MA3 hand finger #2). 

27 MA3 hand tilt. 

36-44 Unused. 
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33 HVD iris. 

34 UVD focus. 

35 UVD mirror. 


36 

PhomDoiaai 

tes t 

table 

pot 

A. 

37 

Rhomboidal 

test 

table 

pot 


40 

Rhomboidal 

test 

table 

pot 

C. 

41 

Rhomboidal 

test 

table 

pot 

D. 


43 Pot box upper left. 

43 Pot box upper right. 

44 Pot box lower rignt. 

45 Pot box lower left. 

46-57 Unused. 

60 TDK output. 

61 Alles hand tilt. 

53 Aides hand extend. 

63 Alles hand rotate. 

64 Alles nand grasp. 

65 AMF arm wrist roll. 

56 AMF arm wrist yaw. 

67-70 AMP arm horizontal high resolution. 

71 AMP arm horizontal absolute position. 
72-73 AMF arm swing high resolution. 

74 AmF arm swing absolute position. 

75-75 AMF arm vertical high resolution. 

77 AMP arm vertical absolute position. 

100-111 Unused. 

112 Joy stick X. 

113 Joy stick I. 

box one (manual iris conrol). 
box two (manual focus control), 
box three, 
box four, 
box five, 
box six. 
box pot one. 
box pot two. 
box pot .three, 
box pot four, 
box pot five, 
box not six. 
box pot seven, 
box pot eight. 

two, one. 
two, two. 
two, three. 


114-131 Unused. 


132 

TVC 

pot 

133 

TVC 

pot 

134 

TVC 

pot 

135 

TVC 

pot 

136 

TVC 

pot 

137 

TVC 

pot 

140 

■lew 

pot 

141 

Hew 

pot 

143 

New 

pot 

143 

New 

pot 

144 

New 

pot 

145 

Hew 

pot 

146 

Hew 

pot 

147 

Hew 

pot 

150-loo 

Unused. 

lOo 

Pot 

box 

157 

Pot 

box 

160 

Pot 

box 
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161 

Pot 

box two, four 

• 


162 

Pot 

box two, five 

• 


163 

Pot 

box two, six. 



164 

Pot 

box two, seven. 


lbt> 

Pot 

box two, eight. 


166 

Joy 

stick 

console 

pot 

ten. 

167 

Joy 

stick 

console 

pot 

nine. 

170 

Joy 

stick 

console 

pot 

eight 

171 

Joy 

stick 

console 

pot 

seven 

172 

Joy 

s tick 

console 

pot 

six. 

173 

Joy 

stick 

console 

pot 

five. 

174 

Joy 

stick 

console 

pot 

four. 

175 

Joy 

stick 

console 

pot 

three 

176 

Joy 

stick 

console 

pot 

two. 

177 

Joy 

stick 

console 

pot 

one. 


3.3.3.1 The .POT'SET UUO 


(some of this section is taken from Reference 13.) 

CALL: .POTSET PTAxsLL 

;return 

PTALLE: ELOCK 4*KUM£MTRIES 

0 


This call gives the user a flexible means of controlling program 
parameters via the input multiplexor. A maximum of 20 simultaneous 
connections between pots and variaoles is permitted. Each may be 
variable fixed or floating point. If fixed point, it may be an 
arbitrary byte within a word. The user may specify a mapping from 
pot values to variable values by giving an upper and lower limit. 
These may be inverted to give a oacswari mapping. 


Two types of 
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control are provide!, absolute and incremental. In absolute mole, 
the true not position sets the value. This may be useful for 
nositioning displayed objects witn a joystick, rhe incremental mode 
permits a variable or set cf variables to be changed slightly without 
causing a discontinuous jump in tneir values. The value is unchanged 
at connect time, but rotating the pot adds its scaled increment to 
the variable. Turning it down in the bottom third, or up in the top 
third of the pot's range causes a faster change so as to keep the 
control near center. The increase in gain is inhibited at low speeds 
to prevent drift due to noise. 

The address of the call points to a table of pot connection (or 
disconnect) specifications. This table consists of blocks of 4 
words, followed by a zero word. The block format is as follows: 

Location Variable 

F00+0 Multiplexor channel,,control bits (see below) 

FOO+1 Btye specification(see below),,variable address 
700+2 Lower limit (value at pot = 0) 

700+3 Upper limit (value at pot = 100000) 

The control bits are as follows: 


Bit Meaning 

2.9 l=>disconnect pot 

0=>connect pot 
1.2 i=>absolute 

0=>incremental 
l=>floating 
0=>fixed 


1.1 
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The byte specification should he in machine byte pointer format (no 
index or indirect allowed) for a partial word and may be zero for a 
full word. 

A .POTSET call is illegal if either (1) the user tries to 
connect a pot already in use by another user, (2) the table is more 
than twenty blocks long, (3) an attempt is made to connect a pot when 
twenty pots are already connected, or (4) the address exceeds the 
user's memory bound. A pot is disconnected when (1) the user 
disconnects it with a .POTSET, (2) the user reduces his memory bound 
below the address the pot controls, or (3) the job is killed. 

3.4 Miscellaneous Devices 

3.4.1 The DIS and IDS Devices 

The DEC 340 display [Ref 1] differs significantly from all other 
devices usable in ITS. In order to maintain an image on the display 
it is necessary to repeatedly output to it a list of display words. 
This list must be stored in main memory and the various means of 
using the dispaly may be divided into those that maintain this list 
in system memory (discussed in this section) and those that allow the 
list to be maintained in the userk core image [Sec 3.4.1.1]. 

Only one Procedure at a time may use the 340 display and in only 
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one of its three modes (as symbolic device PIS, as symbolic device 
IPS, or via the .DSTART and .DSTRTL UUO's). If the display is free, 
.any procedure may seize it by executing a proper .OPEN on device^ PIS 
or IPS or by executing a .PSTART or .DSTRTL UUO. If the display is 
in use, however, a procedure will succeed in any of the above iTuO's 
only if it is the procedure that has the display or it has control of 
device TOO as a console [Sec 3.5]. If the second case applies, the 
channels, if any, on which the other procedure had the PIS or IPS 
open will be modified to the corresponding (block or unit) HUL device 
[Sec 3.4] output. .CLOSE'ing [Sec 2.8.1] all input-output channels on 
which device PIS or IPS are open is the same as executing a .DOLOSE 
[Sec 3.4.1.3] . 

The PIS symbolic device allows the user to output single or 
packed blocks of ASCII characters in A.SCII mode and single or blocks 
of 340 display list half words [Ref l] in image mode. This device 
may be open on more than one channel at a time in possibly different 
modes. If the user outputs characters and then halfwords, ITS will 
automatically insert intervening items to cause the display to escape 
to paramerer mode. If the user outputs half words and then 
characters, ITS assumes that he has inserted items to cause the 
display to escape to parameter mode. A display list produced by 
output to the PIS device will start by setting the 340 display 
intensity to 7, its x and y coordinates to zero and 7000, and its 
scale to one larger than the 3.4-3.5 field of .OPEL mode bits r 5ec 



ITS 1.5 Reference Manual 


Pane 77 


2.2] used unless that field is 3 in which case the scale is set to 
zero. Lines of character output that extend beyond the right edge of 
the screen will wrap around and continue, superimposed on their 
beginning, from the left. Lines of character output that extend 
beyond the bottom of the screen similarly continue from the top. The 
amount of display information created by DIS output may not exceed 
2000 words. After that, further output is ignored. The stored 
information created by output to the LIS device may be deleted to 
accept new information by outputing a ~T or a ~L (form feed) 
character. In the latter case, this action will be delayed for a few 
seconds. 

The IDS symbolic device allows the user to use a semi-idealized 
display. This device is known as the interpreted display since the 
user writes instructions to be executed by a display processor 
which are then interpreted by ITS simulating the processor and 
creating a 340 display list to actually display. The IDS device may 
only be opened in unit output mode and what the user outputs to it is 
the location, in the user core image, for the display processor to 
start "executing”. 

.IOT DISCHN,PC 

• • • 

PC: STRTLC ;location to start 

;updated during execution 
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Almost all error conditions encountered during this "execution" 
cause interrupts to the user [Sec 4.2]. The simulated display 
processor has a push down list facility with its push clown list 
pointer in the user's location 43. The information to he sent by tne 
.IOT'ing [Sec 2.4] of each starting location to the IDS device is 
normally terminated by the display processor POPJ'ing, to zero, 
frequently this is made to hapren by over popping by tne display 
processor. The information stored by the IDS device is currently 
limited to 2000 words. If the 340 display is being run by the IDS 
device when a .IOT is excuted on it, the display will stop and the 
stored information will be over-written. If the 340 display is not 
being run, output from simulation is appended to that already 
present. Whether the 340 display is started at the end of the 
simulation initiated by a .IOT is determined by a display processor 
parameter that may be set during simulation. 

Instructions for the IDS simulated display processor are 
thirty-six bit words interpreted as five left justified ASCII 
characters if bit 1.1 is zero. If bit 1.1 is a one, bits 1.4-1.5 are 
interpreted as the following commands: 

1.4-1.6 Command Other fields 

0 Illegal. 

1 Point. 4.9-3.4 Y, 3.3-1.7 X, 1.2 intensify. 

2 Pel vector. 4.S^-3.4 Y, 3.3-1.7 X, 1.2 intensify. 

3 Increment. 5 left justified 5 bit fields eacn: 

1.1-1.2 length, 1.3 intensify, 1.4-1.6 direction (clockwise from 
vertical). 
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See below. 

5 

Abs vector 

6 

Illegal. 

7 

Illegal. 


1.7-1.9 subcommand function. 

4.9-3.4 Y, 3.3-1.7 a, 1.3 intensify. 


1.7-1.9 

Function 

0 

Illegal. 

1 

PUSKJ. 

2 

POPJ. 

3 

JR ST. 

4 

POP. 

5 

PUSH. 

6 

See below. 

7 

Illegal. 


Other fields 

4.3-3.1 address. 

4.3- 3.1 address. 

4.9-3.1 address. 

4.9-3.1 address. 
4.S-3.1 address. 

2.3- 2.3 parameter 


to set from 4.9-3.1. 


2.3-2.9 Parameter 
0 Illegal. 

1 Start mode (nonzero means start after .ICT). 

2 Character scale. 

3 Increment scale. 

4 Vector scale. 

5 All scales. 

° Coordinate of left edge of displayed area. 

7 Coordinate of bottom edge of displyed area. 

10-77 Illegal. 


3.4.1.1 The .DSTART and .DSTRTL UUO's 


CALL: 


DPMTR: 


.LSTART DPSTR 
;error return 
;normal return 

-LENGTH,,DISLIST-1 


LISLIST: 


“LOCK LENGTH 
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CALL: .DSTRTL PMTRL 

;error return 



;normal return 

PHTRL: 

BPNT2+1,,.+1 


BPIIT2+1,, 0 

BPNT2: 

-LkHGTn, ,i)iSLIST 

BISLIST: 

BLOCK LENGTH 


These LTJO's enable the user to display lists that are in his 
core image. The execution of either attempts to seize the 340 
display and skips only if successful. 

A .DSTART should point at a location that will always contain 
either a ELKO [Ref l] type output pointer, if one block of data is to 
De displayed, or the first word of a linked list of display blocks. 

In this linked list, the right half of each entry points to the next 
entry, or, if zero, indicates the end of the list. The left half of 
each word should be positive and is a pointer to a ELKO pointer or is 
ignored if it is zero or points to a zero word. 

.DSTRTL differs from .ESTART only in that, if it is used to 
display a list of blocks, the left halves of its linked list words 
cU*e interpreted as pointing to the word after not a ELKO pointer but 
a regular block mode output pointer [Sec 2.4]. 
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3.4.1.2 The .LTPEII UUO 


MOVE AC,[COHTKCL] 
MOVEM AC,LBLOCK 
CALL: .LTPEII LBLOCK 

jreturn 

LBLOCK: BLOCK 6 


The 340 display is equiped with a light pen that causes a 
hardware interrupt when the light intensity it sees increases 
suddenly as when a spot is displayed under it. The display also 
stops when this occurs and its current coordinates can be read in by 
the PDP-6. The user may enable software interrupts (class three) to 
his procedures when the lignt pen is seen and he has tne display 
seized [Sec 4.2]. 

This system call enables the user with ihe display seized to 


read information about where the light pen has been seen and the 
state of the current transfer to the display. Results are returned 
in the contents of the effective address and following five 
locations, ihe contents of tne effective address also acts as an 
argument. If bit 4.9 is zero the rest is ignored. But if bit 4.S i: 
a one then bit o.l will cause tne .LTPEK to hang until the light pen 
has been seen at least once and bit 1.1 will be used to set the 
multiple sighting mode. If this mode is on, the light pen may be 
seen many ti^es while a display block is displayed once. 


If this 
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mode is off (zero) the light pen may be seen only once and ignored 
thereafter for each display oi a display block. 

The six words returned to the user are as follows: (1) the 
actual word PATAI ed [kef l] from the 2-40 display at the time of the 
last light pen interrupt, (2) the number of times the light pen was 
seen since the last .LTPEn, (o) the sum of tne y coordinates at tne 
points the light pen was seen since the last .LPER, (4) tne 
corresponding sum of x coordinates, (5) tne current linked list 
pointer, and (6) the current ELKO pointer. 

3.4.1.3 The .DCLOSE UUO 

CALL: .DCLOSE 

;return 

This system call releases the 340 display if executed by the 
user who nas the display seized, closing any channels on which it is 
open. Otherwise it does nothing. 

3.4.1.4 The .DSTOP UUO 

CALL: .DSTOP 

;return 

This system call stops tne 340 dispiav f 


but does not release it, 
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if executed by the user who has tne display seized. Otherwise it 
does nothing. It is intended for use in conjunction with the .DSTaAT 
or .1)STRTL UUC. 


3.4.1.5 The .KDIS UuO 


MOvEl AC,69. 
CALL: .IIDIS AC, 

;error return 
;normal return 


This system call is intended for use in taking pictures of 340 
displays. It sets a display control variable from the contents of 
the accumulator it specifies. This variable has no effect if it is 
negative but if zero it inhibits display conjpleteiy and if positive 
it is decremented by one each time tne current display block or list 
of blocks is displayed. This call skips unless executed by a 
procedure that does not have the display assigned to it. 

3.4.2 The USE Device 


The USE device actually represents procedures 
• OPEN [Sec 2.2] executed on device USE. will either 


. A successful 
create a new 


procedure 

associate 


[Sec 5.1.1], attach a disowned procedure tree 
with the input-output channel on which it was 


i_oec 5. l.nj , 
executed an 
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existant procedure or allow the user access to the PDP-10's memory 
[Sec 3.4.2.1]. The file names are the UEAME and JNAi-ljfi of tne 
procedure being .OPEE'ed. Only immediate inferiors may be .OPEN'ed 
to write into but any procedure may be examined. If an inferior 
procedure has been opened, it may be destroyed oy a .UCLOSE LSec 
5.2.1] but will be entirely unaffected by a .CLGSn [Sec 2.7.1] 
executed on the channel. The same procedure may be open on more than 
one channel of its superior, possibly in different modes. It is at 
first .OPEN time that an interrupt bit [Sec 5.1.3] is assigned by ITS 
to a procedure. The number of inferior procedures a procedure may 
have is currently limited to sight. 

The 3.3 mode bit [Sec 2.2] is ignored in .OPEh's on device U3R 
but both block and unit modes are available. Executing .ICT's on 
channels opened on device USK results in the transfer of a thirty-six 
bit binary word or words between the procedures. The location in the 
.OPEM'ed procedure of the first word to be transfers! is specified by 
the .ACCESS [Sec 2.7.5] pointer associated with the input-output 
channel on which the transfer is occuring. Each word transferal 
advances the appropriate pointer by one even in unit mode which ITS 
treats internally as blocks of length one. An attempt to read a word 
beyond the core allocated [Sec 4.3] will result in a class two 
interrupt [Sec 4.2] but in a similar attempt to write (possible only 
for an immediate inferior) ITS will attempt to extend the procedure's 
core image and an interrupt will result only if more core is 
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unobtainable. 

executing a .RESET [Sec 2.7.2] on a channel with an inferior 
procedure open on it is equivalent to executing a .UCLQou and then a 
.OPeE to recreate the procedure (with reset variables,.one 2000 word 
block of cleared, core, etc.) but v/itn less overhead. 

3.4.2.1 The PDP-10 

An .0PEE on device USR witn a second file name of "PDPIO" may be 
made, in all the modes allowed for regular procedures, to access the 
memory of the PDP-10. .IOTs attempting to read or write tne PDP-10's 
accumulators will be ineffective and read or write the core locations 
shadowed by tne accumulators. Attempting to reference above the 
PDP-10 s memory will result in illegal user address interrupts. Cnly 
the procedures of one procedure tree may have the PDP-10 open at a 
time, possibly on more than one channel at a time in different modes. 

Attempts to set or read variables for the PDP-10 "inferior” are 
ignored except that 40000 will be read as its memory bound. A .RESET 
executed on a channel on which the PDP-10 is open will clear its 


emory. 
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3.4.3 The CLA, CLI, CLO, and CLU Devices 

These symbolic devices enable arbitrary uairs of procedures to 
tall: to each other as buffered input-output devices. Each file on 
any of these core link” devices represents a 200 word area, most of 
which is buffer, which may be simultaneously open for reading, 
writing, both or neither. The files are identified by two regular 
file names and a system name [Sec 2.2, 2.2.5]. Only one procedure at 
a time may have a core link open to write or read on one channel. 

All standard modes are available. 

The CLO (Core Link Open) device may be used to open any core 
link file and (whether reading or writing) will create one if none 
exists with the name used. The CLU (Core Link Use) device is 
identical except that and .OPEN on it will fail if the referenced 
file does not already exist. 

Core link files have some peculiar properties. When writing a 
core link, a procedure will hang if the buffer is full and will write 
an end-of-file mark outside of the data stream when it closes tne 
channel it has the file open on. However, opening and writing again 
the same file name essentially pushes a new block of data into the 
pipeline to be removed by a reading procedure. A procedure reading a 
core link ^an not read past an end—of—file and must close and reopen 
the file if it suspects that there is more to follow. If a reading 
rrocedure closes a core link before encountering ani end-of-file, 
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remaining information until the end-of-file is ignored. Core link 
files cease to exist only if empty and open for neither reading nor 
writing or not empty and not open for from two to four minutes. In 
the later case they are expunged by the system job [Sec 6.a] to 
unclutter the system. 

The CLI (Core Link Interrupt) device may only be opened to 
write. The two file names specified should be the UNAME and JNAME 
[Sec 5.1] of a procedure in the system with the CLI interrupt [Sec 
4.2] enabled. If there is no existing, core link with the file names 
and system name used, the .OPEN will succeed in creating a link and 
interrupting the specified procedure. In addition ITS inserts in the 
created link two words of information as the start of the first file. 
These are the UNAME and JNAME of the .GPSN'ing procedure. 

The CLA (Core Link Answer) device is to be used in response to a 
CLI interrupt. It may only be opened for reading and scans through 
all existing links for one with file names the same as the UNAME and 
JNAME [Sec 5.1] of the procedure doing the CLA open. If one is found 
not already open for reading, the .OPEN succeeds. 


3.4.4 The ERR Device 


This device, by a mechanism similar to that used for the 
directory device [Sec 2.2.1], allows the user to input a character 
string explaining whatever error indication there may be in a .STATUS 
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word [Sec 2.5]. 

The first file name specified on an .OPEN on device ERR must 
numerically he either 1, 2, or 3. If it is 1, Uie status of tne last 
input-output channel on which there was an error will be analyzed. 

If it is a 2, the bottom four bits of the second file name specify 
which innut-output channel to examine. If a 3, the second file name 
is treated as the .STATUS word to analyze. 

3.4.5 The TPL Device 


This device allows a user to output a file to be line printed 


[Sec 3.2.2] at some later time when the line printer is free and such 
print out has not seen inhioited [Sec 6.5.1], In a manner similar to 
the COM and SYS [Sec 3.1.3], this device refers to files on tne dish 
with system name .LPTR. . However, renames are ignored on the TPL 
device and, while reads work normally, on writes the supplied file 
names are ignored, instead, the uiIAilE of the procedure writin— is 
used as the first file name and a counter of how many files have been 


written on the TPL device in the current system run is used as the 


second file name. 


Piles 


written on the 1PL device are printed out by the system 


job [Sec o.5] when the line printer 
time (up to two minutes) is left bet 
i?L print out and between successive 


is free. A significant length of 
ween non-TPL line printer use and 
T?L output to allow local users 
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to seize and use the line printer directly. 


3.4.6 The 3UL Device 


This device has all standard inodes and is a hign speed 


:e 


infinite 


sink on output and source of zeros on input. 
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4. The Procedure 


See also section 0.2.3. 


4.1 Philosophy and Organization 


The use of ITS is entirely Procedure oriented. Almost all 
system actions are caused by trapping instructions [Sec 1.2; App A, 
r] executed by user programs that are hier&rchially organized [Sec 
5.1]. A large number of variables [App D; Sec 4.5] iW associated 


with each procedure by the ITS system. These variables are stored 
the system and do not impinge on the user's core image. 

These procedures are run for short fixed lengths of time or 
until they become unrunnable (whichever comes sooner) in an order 
determined by the scheduler [Sec 4.4], The scheduler also handles 
software interrupts to the user [Sec 4.2]. When in execution, user 
programs run witn the ?DP—6 in user mode [Sec 1.2.2] which enables 
protection and relocation hardware that ITS sets in acordance with 
the length [Sec 4.3] and location in absolute memory of the 
particular procedure's core image. 

The following are among the advantages of this storage of user 


in 


variables: 
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(1) Mo effort by a user's Procedure to randomize its core image can 
effect system variables related, to the rrocedure and tnus erase 
evidence of system malfunction or lack of malfunction. 

(2) A rrocedure s core image may be easily swapped out without 
significant reduction in information concerning it of interest to the 
system or the necessity to retain some portion^of it. 


4.2 user Interrupts 


IiS provides software implemented interrupts to the user program 
similar to the hardware interrupts it receives. Only one level of 
interrupt is simulated hut this makes little difference due to tne 
ease with which the user can inhibit or enable various types of 
interrupt [Sec 4.2.1] and may also re-enable interrupts without 
immediately or ever returning to the location his program was 
interrupted from. 

Each procedure has in system memory two interrupt enable mask 
v/ords, two interrupt request words, and a flag indicating interrupt 
le^el otatus [App j]. Various conditions that can cause interrupts 
are assigned bits in these interrupt request words. These conditions 
are divided into three classes according to severity as follows: 


(1) Class one conditions, the^most severe, can not be enabled. They 
always cause the .interrupted program to be stopped and its superior 
procedure to receive an interrupt. 


(2) Class two conditions 
enabled to interrupt the 
while the user's interrun 


are of moderate severity. They may be 
user but if they occur while not enabled 
t level flag indicates ne is currently 


or 
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processing an interrupt, he will be stopped and nis superior 
procedure interrupted. 

(3) Class three conditions are the least severe and may also be 
enabled to inter runt tne user. ,:hiie not enabled tney have no 
effect. If enabled and they occur while the user / s interrupt level 
flay indicates he is free to receive interrupts he will be 
interrupted but if the user's flag indicates he is not free they will 
be stored in the interrupt request words to be presented to the user 
as soon as he allows unless reset with an .SUSET [Sec 4.5J . 


In cases mentioned above (for c^]/ss one and two) when a 
procedure's superior is interrupted, tne particular bit used to 
interrupt the immediately superior procedure is in its second 
interrupt request word. A bit is assigned by ITS to that inferior at 
the time it was created [Sec 5.1.3] and can oe read with a .USE! [Sec 
5.2.3j . 


When conditions that would cause a procedure's superior to be 


interrupted occur in a top level procedure one of two things may 
happen. If the Procedure tops a console controlled tree, a new 
: -ACiRR will be loaded (as in section 1.1) and all inferior procedures 
will be lost. If the procedure tops a disowned tree [Sec 5.2.2] it 
will be immediately stopped and when next attached [Sec 5.1.2] by a 
job tree the attaching procedure will be appropriately interrupted. 

ITS determines that it should actually interrupt a procedure 


when it sc.neu.ules [Sec 4.4]., or the procedure executes 
[Sec 4.2.2], or .SUSuiT [bee 4.5] of the PICLR variable 
corresponding cits on in one or both of the procedure's 


a .DISMISS 
if there are 
interrupt 
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request and mask words and its interrupt level flag (PICLK) indicates 
interrupts are enabled. ITS examines tne contents of tne procedure's 
location 42 to see if its direct address (indexing and indirect 
addressing ignored) is between location 20 and the location 6 less 
than the top of the user's core image, inclusive, if not, the user 
receives a class one interrupt for a bad location 42. If so, the 
user's appropriate interrupt word (first word nas nigher priority 
than the second), containing bits on for interrupts tne user is being 
presented with, is placed in the word directly addressed by the 
user's location 42 and bit 4.9 of that location is turned on if 
second word requests were stored. The interrupt request word stored 
is then cleared to receive future interrupts. The user's interrupt 
level flag is also set to inhibit further interrupts, finally a JSR 
[Ref 1J is simulated to a location one greater than that in wnicn the 
interrupts were just stored. Tne normal manner to return from an 
interrupt is with a .DISMISS [Sec 4.2.2]. 

The following is a list of word one interrupt bits: 

Class Condition 

3 Character typed at console [Sec 3.2.1]. 

1 Z typed [Sec 1.1.2]. 

1 fad location 42. 

3 AR overflow [Ref l] . 

1 Display list memory protection violation [Sec 

2 Illegal insiruciion. 

3 System going down in 5 minutes [Sec 5.5.2]. 

1 .VALUE executed [Sec 5.3.1]. 

2 Input-output Channel error. This interrupt 


fit(s) 
1.1 
1.2 

1.3 

1.4 

1.5 

3.4.1] . 

1 . 6 
1.7 
1.3 
1.9 
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always occurs at an 
with its ac field., 
more exact cause of 
device [Sec 3.4.4]. 
2.1 2 

inferior procedure 
2.2 1 

a. 3 1 

6.7] . 


•I°'r LSec ^.3] or .OPER [Sec 1.2.lj that refers 
to the channel on which the error occured. ror 
interrupt use a .STATUS [Sec 2.d] or tne ERR 

Memory protection violation on reference to 
[sec 2.4.2]. 

.BREAK executed [Sec 5.3.2J. 

Return from single instruction proceed [Sec 


t 


2.4 3 

2.5 2 

2.6 2 

2.7 3 

2.8 3 

2.9 3 
3.1-4.8 - 

4.9 
"below. 


Slow clock (every half second). 

Memory protection violation [Ref l] . 

MAR interrupt [Sec 6.4], 

Liant pen LSec 3.4.1.2]. 

PEL overflow [Ref l]. 

CLI [Sec 3.4.3] device interrupt. 

Not used. 

Indicates rest of bits to be interpreted as 


In the second word of interrupt requests, bits 3.1-3.3 represent 
inferior procedures [Sec o.l.3] and cits 1.1—2.7 represents 
input—output channels [Sec 2.1] with 1.1 for channel zero. 
Interrupts occur from inferior procedures as described above for 
class .one or two interrupts to the inferiors while an input—output 
channel will try to interrupt if there is buffered teletype [Sec 
5.2.1] input on the channel. These buffered characters may be 
examined at the interrupt level with .ITIIC [Sec 2.7.3]. 


4.2.1 The .SETM2 UUO 


A procedure can examine and modify all 


of tne five variable 


words associated with interrupts to it by means of 


the 


. SuSEt UuO 
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LSec 4.5]. When a procedure is first created LSec 5.1.l] or has a 
.RESET executed on it [Sec 3.4.2] ail or these five variables are 
zero except PiCLR which is set to minus one. for the mask (MShST and 
MSEST2) and request (PIRQC and IPPIR) words a one hit represents an 
enabled interrupt or pending request and a zero represents an 
inhibited interrupt or lack of request. ITS will ignore attempts by 
the user to enable a class one interrupt (first word mask bits 1.2, 
1.3, 1.6, 2.2, and 2.3). To avoid certain timing errors, special 
•SUSET means (APIHQ and IPIRQ) are provided to turn on or off bits in 
the first request word without affecting other bits in that word. 

j.he procedures interrupt level flag (PICLR) can also be read or 
set. Its zero stats indicates that interrupts are inhibited and 
class two interrupts oecome fatal. If nonzero, interrupts are 
enabled. ITS sets tnis variaole to minus one when it executes a 
.DISMISS from a user, but when a user attempts to set it the word ne 
stores there with .SuSEf will be shifted right thirty five places. 

Thus the user can set his PICLR to either zero or one depending on 
the sign bit of the word he stores. As a result he can enable 
interrupts (even in the middle of nis "interrupt routine") in a manner 
distinguishable from the automatic enablement performed oy ITS or 
inhibit interrupts. 

ihe aoove discussion also applies to examining and modifying 
these variables in inferiors with .USET [Sec 5.2.o]. 

To avoid certain timing problems there is a special UUO by which 
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a procedure may set both its mask words at once as follows: 


MOVE AC,[MASKV/l] ;set up first word of mask hits 
TOVE AC+1,[MASKW2] ;set up second word of mask bits 
CALL: .SETM2 AC, ;set both mask vars from AC & AC+1 

;return 


4.2.2 The .DISMISS UUO 


TSINT: 


CALL: 


LOC 42 
JSR TSINT 

0 ;interrupt bits stored here 

0 ;loc interrupted from stored here 

••• ;interrupt routine 

• • • 

• • • 

.DISMISS TSIHT+1 ;returns to where interrupted from 


This system call provides the normal means to return to an 
interrupted routine. It simultaneously re—enables interrupts and 
transfers to the location addressed by the right half of the contents 
of its effective address, restoring flags from the left half. This is 
normally, but not necessarily, the pseudo-JSR word stored by ITS as 
it simulates an interrupt. If there are pending conditions in the 
user s interrupt request words he will be immediately re-interrupted. 
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4.3 The Core Allocator 


The core allocator consists of a single special procedure, 
called the core jot, that does most of the work and various routines 
that signal to it their interest in acquiring or releasing core. 

An internal map of the status of every 2000 word block of memory 
exists in the system arid is maintained ty the core allocator. The 
majority of the complexity of the core allocator is not due to 
maintaining this table hut to tne actions it must sometimes take to 
relocate input—output buffers and other occupants of core when a 
procedure wishes to expand. The lack of pagGing on the PDP-6 maxes 
it sometimes necessary to "shuffle" core to make a sufficient 
contiguous block. 

Each 20C0 word block must, except for two transient states, be 
devoted to one of the following uses: (1) part of a procedure's core 
image (ITS code and variables appear as core allocated for the system 
job [Sec 6.5]), (2) a disk buffer or directory [Sec 3.1.1], (3) a 
display buffer [Sec 3.4.1], (4) unused, or (5) further subdivided 
into 200 word blocks. These 200 word blocks are used for core link 

device buffers [Sec 3.4.3] or for DEC tape buffers or directories 
[Sec 3.1.2], 



A procedure may 
4.3.1] and dete 


request more or less core by means of a .CORE 
rmine its memory bound without making protection 
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violations with a .3U3ET [Sec 4.5]. Other than tne .CORE UUo a 
procedure's memory hound may he affected only by its destruction, 
when all blocks in its core image are marked free, or a .uSnT [Sec 
5.2.3] or .IOT on device USR [Sec 3.4.2] executed by its immediate 
superior. 


4.3.1 The .CORE UUO 

CALL: .CORE TIUM5LK 

;error return 
;normal return 

This system call requests for the procedure executing it as many 
2000 word clocks as the value of its effective address except that if 
this value is zero it will be treated as if it were one. If and only 
if the .CORE is successful it skips. Only a .CORE to acquire more 
core may fail. If it does and a more than one block increase was 
being requested, some smaller number than requested may have been 
obtained. 

4.4 The Scheduler 

xhe scheduler runs when a quantum time-out occurs or when tne 
physically running procedure encounters a blocking condition or 
causes an interrupt by some program action (memory protection 
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violation, PPL overflow, etc.)* The scheduler decides which 
procedure should run next by an examination of tne variables [App D] 
in the system for each procedure. It simultaneously performs those 
modifications of these variables necessary to provide tne simulated 
interrupt feature [Sec 4.2]. 

For those procedures that have their stop word (USTP [App D]) 
zero, their runnability is determined by a variable known as the 
flush instruction (FLSINS) which is set when the procedure becomes 
blocked. If this variable is zero the procedure is runable. If 
nonzero it is executed with the procedure's FPDL2 variable [App D] 
loaded into ITS symbolic accumulator T. If the instruction skips 
then the procedure is runable and has just become unblocked. If the 

A 

flush instruction does not skip the procedure is still blocked. 

j.he next procedure to be run is picked from among the runnable 
procedures by a scan which considers two "resource" variables per 
procedure. Roth of these are quantized approximations to exponential 
decays toward proportions of machine time. The JTMU variable is 
associated with a particular procedure while the UTMPTR variable 


pointer for that procedure points to a quantity similar to JTMU 
maintained for all procedures in one console controlled tree. During 
the scan to select the next procedure to run, a procedure will be 


pref i 


bes t 


console tree has used 1; 


recently than that of 


best so far or its console iree has used 


exactly the same amount and the procedure has used 



\ 
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recently. Exceptions to this are that a procedure is always 
■preferred to the best so far if it has used less man one eighth as 
much time recently and never preferred if it has used more than eight 
times as much. Also the procedure, if any, that has seized the. 
•VASTER [Sec 6.3.5] facility is given double priority and disowned 
procedures are given one eighth priority unless they nave the line 
printer (device LPT) assigned to them or are running in executive 
mode when scheduled. 

All disovmed [Sec 5.1] job's UTMPTR's point to a single word 
which is given less resource than that for a normal console tree. 

The system job [Sec S.5] and core job [Sec 4.3] have UTMPTR's to 
separate words given the same priority as a normal tree. 

The general properties cf this scheduling system can be 
described as follows: 


(1) Machine time is normally equally divided between consoles and 
then between all the procedures running for each console. 

(2) Machine time used by a procedure is integrated with decay (time 
constant about seven seconds) so 

(a) a procedure that is frequently blocked for a short period of 
time (compared with a quantum, currently one fifteenth of a second) 
should receive equal service with a pure compute job and 

(b) an interactive program called on infrequently by a user is 
essentially guaranteed good service as it starts to think of a reply 
but can not, on average, use more time thfan a pure compute job. 
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4.5 The .SUSET UUO 


CALL: .SUSET [LRECTIOE+VARIAELE, ,DATLOCj 

;return 

DATLOC: ;location read into or written form 


Procedures may examine and modify some of their system variables 
[App D] by means of this system call. The contents of its effective 
address (a constant in the illustration above) is viewed as two half 
•words. The right half should point at the word from which the 
variable is to be set or into which the variable is to be read. The 
left half specifies by its top bit (4.9) whether the variable is to 
be read (zero) or written (one) and by the value of its remaining 
bits which system variable. The following table lists permissible 
values: 


Tame 

Value 

Tyne 

Variable 

UPC 

0 

07 

Program counter word [Ref l]. 

VALUE 

1 

17 

Contents of effective address of most 

recent .VALUE [Sec 5 

.3.1] . 


TTY 

2 

05 

Status relative to console [Sec 3.2.1]. 

ELSIPS 

3 

01 

blocking condition [Sec 4.4]. 

Ur! ARE 

4 

05 

UEAME [Sec 3.4.2]. 

TEAMS 

rx 

uP 

07 

JI'IAME [Sec 3.4.2]. 

MASK 

6 

17 

Interrupt mask word [Sec 4.2]. 

U3TP 

7 

03 

Stop word (only bit 4.7 can be written) 

[Sec 4.4]. 



PI see 

10 

17 

First interrupt request word [Sec 4.2]. 

hits 

5 i ml 

11 

01 

Tit used to interrupt superior [Sec 

Meat 

12 

07 

Memory bound [Sec 4.3], first location 

it would be 

illegal 

to ref 

erence. 
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SV40 13 05 Last executed U'JG trapping to system 

[Sec 1.2.1]. 

IPIEQ 14 IT Interrupt renuest word (written by an 

IOHM). 

APIRQ 15 17 Interrupt request word (written by an 

APDCAii). 

SHAME 16 17 System name [Sec 2.2.3]. 

PICLR 17 17 Interrupt level status word [Sec 4.2]. 

MARA 20 17 MAR register and control bits [Sec 6.4]. 

MARPC 21 17 Program counter at last MAR interrupt 

LSec 6.4]. 

UUOK 22 05 Program counter word at last system uUG. 

UIMD 23 05 user index. 

RUST 24 05 Total run time in 4.069 microsecond 

units. 

MSK2 25 17 Interrupt mask word two [Sec 4.2]. 

IPPIR 26 17 Interrupt request word two [Sec 4.2]. 

APRC 27 05 Disowned and processor cono status. 

SV60 30 05 Saved absolute location 60. 

31—77 00 Unused. 

IOC 100+11 01 Input-output channel word for channel K. 

IOS 120+11 01 Status word for input-output channel K. 

IOP ^ 140+11 01 11th word of input-output channel push 

down list [Sec 2.6], two words per entry. 


In the above table the 1.3 bit on in the type column implies 
that the variable can be read with .SUSET and the 1.4 bit implies it 
can oe written with .SUSET. The other type bits relate to the .USET 
TJuO [Sec 5.2.3]. 


Pre-defined symbols are available in the MIDAS assembler 


consisting of a 


followed oy an R for read or a ‘V for 


followed, by the string in the name column of the above table for all 
its entries. 
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5. Procedure Interaction 


See also section C.2.4 ana 5.4.2. 


5.1 The Hierarcnial Organization of Procedures 


All procedures operating under ITS are members of a tree 
structure recorded in the system by associating with eacn a pointer 
to its immediate superior. If this pointer is minus one it indicates 


that the procedure tops a tree. These trees may be of two types, 
those under the control of a console and those that are disowned [Sec 
5.2.2]. 

Console controlled’* trees have had their top level procedure 
automatically loaded by ITS [Sec 1.1]. Since procedures may control 
their inferiors and the most that the user can do in appealing for 
aid when confronted with recalcitrant programs is to cause his 
console to converse with higher level procedures [Sec 1.1.2], he is 
actually at the mercy of this top level program. It is currently a 
DDT expanded by the addition of new commands related to time sharing 
[Sec ?J. About the only restrictions deliberately inserted in it 
relate to logging in [Sec 6.1], 

disowned procedure trees differ from console controlled trees 
only m the following ways: (1) they nave no console associated witn 


tnen; (2) class one interrupts in 


to? level procedure are handled 
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differently [bee 4.2]; (3) they are scneauiel with lower priority 
[Sec 4.4]; (4) certain system calls, when executed in them, are 
treated as illegal instructions; (5) certain input-output devices are 
not accessible by them. 

There exist a variety of means for procedures immediately above 
and below each other to interact [Sec 5.2, 5.3]. Procedures may also 
at feet any procedure beneath them in the procedure tree by means of 
input—output translation table entries [Sec d,d,d] and an arbitrary 
pair of procedures may converse treating each other as input-output 
devices [Sec 3.4.3]. 

Among the advantages of the above system of procedure 
organization are the following: 


(1) The highest level command processor (the top level procedure of a 
console controlled tree) may vary arbitrarily from user to user. In 
actual operation it is normal to see HACIRoPs whose inferior 
procedure variables and symbol tables much exceed their code. 

(2) llew versions of the highest level command processor may be 
introduced simply by writing a file on the disk with no interruption 
to system continuity. 

(3) dew versions of the highest level command processor may be easily 
and salely debugged by loading them as interior procedures. In this 

position they can exercise all their normal functions exceot logging 
in and out. * 0 


(4) It is not neccessary to make every effort to remove all bugs from 
the highest level command processor for fear that tne system may be 
destroyed by them, a consideration often inhibiting more complex and 
powerful command languages. A fatal error simply results in the 
program being reloaded. 


(3J Jsers nave great generality in creating command levels of their 
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own. 


(6) Muiti-tasx programs nay be organized in a consistent manner. 


I tens 1, 2, and 4 above argue to various extents against pure 
procedui es as does iheir innerent speed inefficiency. Raving to 
maintain separate copies oi the highest level command processor for 
each user is not that significant a disadvantage if one considers the 
amount of each copy's core image unique to each user and that while 
not in actual use they could he swapped out of the system. 


5.1.1 Procedure Creation 


Procedures may he created only by typing 'l on an idle teletype 
[Sec 1.1.i] or hy executing a .OPEh [Rec 2.2] on device USR i^ec 
3.4.2]. In the second case, which is discussed here, there are 
strict requirements on the 'file name' used in the .OPEN. The first 
tile name, which will be the UnAM-E of the created procedure, must he 
the same as the URAM2 of the procedure executing the .OPEN. The 
second file name, which will be the JuAifh of the created procedure, 
must be different from the JTIAME of ail jobs then in existence that 
have the URAnh being used. A procedure may nave a maximum of eight 
directly interior procedures. A newly created procedure will have 

one mOuu word rlocm of cleared memory am all of its system variables 
initialized. 
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5.1.2 Attaching Lisowned Procedure Trees 

The only case in union a successi'ul .OPEu [Sec 2.2] on device 
U3R [Sec 0.4.2] may oe executed to provide an inferior procedure (as 
opposed to opening a procedure for examination only) with a first 
file name different from the UNAME of the procedure executing the 
.OPEN is that ii which the top procedure of a disowned tree is being 

A. 

opened. This type of .OPEN will be treated as an illegal instruction 
if executed by a procedure in a disowned tree. If not and the 
opening procedure has less than eight inferiors the open will succeed 
and ITS will modify the UNA.ME of the opened procedure and its 
inferior tree to agree with the opening procedure. It will then take 
each UEAME JNAME pair in the attached tree and make it unique by 
incrementing the JNAME part if necessary. 


5.1.3 The .UTRAN UUO 


CALL: .UTRAN EBLOCK 

;error return 
;normal return 

EBLOCK: INTBIT,, 

0 

0 


no inferior found for int bit 
inferior found 


UNAME stored here by call 
JNAME stored here by call 


Then a procedure is first created by a 


.OPEN 


9 


assigns lo it 


ITS 
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a Tit for use in interrupts [Sec 4.2] to its superior procedure 
different from that for any other inferior procedure its superior may 
have. Since inferior Procedures can only be directly controlled wnen 
ouen on input—output channels, the loss of the name of an inferior by 
its superior while it was not open would result in complete loss of 
communication. Although procedures that have inferiors normally keep 
close track of their names and interrupt hits as read by .USET's [Sec 
5.2.3], this system call has been provided to translate from 
particular interrupt bit to name of inferior. The left half of the 
contents of the effective address must have only the appropriate 


interrupt bit on. If a corresponding inferior procedure is found, 
the .JiRali skips and the UTT AME and J1IAME of the inferior are stored 


in the two words after the word containing the interrupt bit. If no 
corresponding inferior is found the .UTRAN will fail to skip and the 
two locations after the location it effectively addresses will be 
unmodified. 


5.2 Controls over an Immediately Inferior Procedure 


See also section 3.2.1.1. 
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5.2.1 The .UCLOSE UTJO 

CALL: .UCLOSE CHNUM, 

;return 

Procedures may he destroyed only by the execution of a .LOGOUT 
[Sec 6.1] or a .UCLOSE. The second of these two system calls, which 
is discussed here, destroys the inferior procedure open on trie 
channel specified by its accumulator field (CKEUU in the above 
illustration) and the entire procedure subtree of which this 
inferior is the top procedure. If an inferior is not open on tne 
channel, the .UCLOSn ing procedure will receive an input—output 
channel error interrupt. .CLOSE'S [Sec 2.7.1] are automatically 
effected on all channels of all the destroyed procedures and any 
system resources they claim are surrendered (by possibly simulating a 
.LCLOSE, .HAUu-UP, and^r .MASTER). In order to hill certain cancerous 
types of procedure subtrees it has been found necessary t.n 
implement this system call such that it first stops all procedures in 
the subtree and then destroys them. 

5.2.2 The .DISOWN T JU0 



ITS 1.5 Reference Manual 


r 'age 109 


CALL: .DISOWN CHTJM, 

;re turn 

This system call requires that an inferior procedure be open on 
the channel specified by its accumulator field (CKNUi-i in the above 
illustration) or the .DISOWN'ing procedure will receive an 
input-output channel error interrupt. It causes this open procedure 
to become the top procedure of a disowned tree [Sec 5.1] and in the 
process closes all channels on which the disowning procedure has it 
open. A procedure in a disowned tree that tries to execute this 
system call will be unsuccessful and receive an illegal instruction 
interrupt [Sec 4.2] as will a procedure trying to disown a subtree 
that controls the tree's console [Sec 3.2.1.1]. 

5.2.3 The .U5ET DUO 

CALL: .USET,[DIRECTI0N+7AEIAELE,,DATL0C] 

;return 

DATLOC: ;location read into or set from 


This system call was created to allow a procedure io set and 
read many of the system variables [App D] associated with its 
inferiors and to read variaoles associated with otner procedures. 
Then executed its accumulator field must contain the number of a 
channel (or. :Ua in the above illustration) on which a procedure is 
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ouen or the .USET ing procedure will receive an input-output channel 
error interrupt. Otherwise its is very similar to .SU5ET [Sec 4.5], 
Heading is allowed if the 1.1 hit is on in the type column of tne 
table in section 4.5. netting is allowed for immediate inferiors if 
the 1.2 hit is on in that table. 

5.3 uommunication to an Immediately Superior Procedure 

5.3.1 The .VALUE UUO 

.VALUE ARGLOC 
;return if restarted 

;trasmitted to superior procedure 

A proceuure executing this system call receives a class one 
interrupt [Sec 4.2] stopping it and interrupting its superior 
procedure, ^he contents of the effective address is saved in a 
system variable associated with tne procedure [App D] so its superior 
can easily retreive it with a .USET [Sec 5.2.3]. 

5.3.2 The .BREAK UUO 


CALL: 

ARGLOC: 
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CALL: .IREAL ARC1,ARC2 

;return if restarted 

The accumulator field and effective address of this UUO are 
ignored by ITS. A procedure executing it receives a class one 
interrupt [Sec 4.2] stopping it and interrupting its superior 
procedure. 

5.4 The .GUN UUO 


ROVE I AC ,USRI!TLEX 
CALL: .GITA AC, 

;failure return 
;normal return 


This system call, intended for use as a last resort, allows any 
procedure in a console controlled tree to expunge another tree from 
the system. The procedure specifies the tree to be .C-UN'ed down by 
the user index (see section 8.2, mode R) of its top procedure. This 
is used instead of one normally unique ouAME JNA.-iE pair so that easy 
reference may be had to procedures not logged in [Sec 6.1], The 
contents of the accumulator specified by a .GUN must be the user 
index (can be read with .USST) of a top level [Sec 5.1] procedure 
otner than the system job [Sec 5.5] or core job [Sec 4.5]. If the 
procedure executing the .GUN is In a disowned tree it will receive an 




illegal instruction interrupt. 


The .GUN ships if successful at which point the system jot will 
have been informed of the tree it is desired to expunge, which action 
the system job will, in due course, perform, also typing out an 


appropriate message. If the above restrictions on the specified user 
index are not met the .G-tld will return without shipping. 
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6. Miscellaneous System Calls end Features 


See also section 0.2.5. 



6.1 The .LOGIN and .LOGOUT UUC's 

These two system calls are the only ones that are effective only 
at the top level. 

CALL: .LOGOUT 

;return if not top level 

.LOGOUT has no effect and simply returns from the system to the 
instruction following if not executed in a top level procedure. It 
causes the nrocedure tree in whose top procedure it is executed in to 
be expunged from the system. It works for both console controlled 
trees and disowned trees. Since the normal means to create [Sec 
5.1.1] and destroy [Sec 5.2.1] a procedure under ITS are calls in a 
superior procedure, tne special case of the top level procedure must 
be handled -differently as it is by ~Z [Sec 1.1.1] and .LOGOUT. 

MOVE AC, [3IXBIT /NAME/J 
.LOGIN AC, 

;error return 
;normal return 


CALL: 
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.LOGIN is not restricted to top level procedures by ITS bat 
rather by HACTRN, the top level procedure IiS automatically loads 
[Sec 7j. A .LOGIN represents an attempt by a procedure to set its 
UNAME to the contents of the accumulator specified. This is allowed 
by ITS only if the procedure's current UK ARE is minus one (as the 
UNAmn of initial RACTRL s is set) and the desired UNAiiE is neither 


zero, minus one, nor the UNAME of an extant console controlled tree 
The success of a .LOGIN is signalled by its skipping. HACTRN will 
not open inferior procedures for a user until he has successfully 
logged in at which point his inferior procedures will nave UNAME's 
dooming future .LOGIN'S in that tree to failure. 


w • 


5.2 Nonstandard Devices 


5.2.1 The .RDSW UUO 


CALL: 


•HDSVr AC 
;return 


This system call reads (DATAI's [Ref lj) the contents of trie 
data switches on the PDP-5's console into the specified accumulator. 
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.2.1 ihe .RD760 and • <<R iR;0 jUC s 


CALL 


.RL7G0 AC, 
;return 


CALL: 


MOVL AC,[BITS] 
.WR750 AC, 

;return 


These system calls respectively read tne data register (JjaTaI) 
of the device whose PDP-o device number is 760 into the specified 
accumulator and output (LATAC) from the specified accumulator to tne 
data register of the device [Ref 1]. The hits in tne data register 
of this device are usually used for temporary direct control or 
sense hookurs. Currently the bottom six tits control lights on tne 
hand of the ArfP arm [Sec 3.3.2], 

6.2.3 The .RL710 UUO 


CALL: .RL710 AC, 

;return 


The real time clock, which ITS currently uses 
quanta, has, as well as an interval timing counter 
which is neither set or stopped ty ITS. 


to time user 
a clock counter 


This system call reads into 
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the specified accumulator a word v;hose bottom twenty four bits are 
this clock counter. It is incremented, once every 4.069 microseconds. 

5.2.4 The .RL500 UUO 

CALL: .RL500 AC, 

;return 

This call reals (BATAI's) into tne specified accumulator from 
device 500. This device is purported to be or become yet another 
kind of clock. See Paul LeCoriolis for more information. 

6.3 Various Times and the Late 

6.3.1 The .RDTIME UUO 

CALL: .RDTIME AC, 

;return 

This sytera call reads into the specified accumulator tne 
internal system time whicn is a word set to- zero when a system is 
first loaded and is incremented.every thirtieth of a second 
thereafter. This quantity is useful in conjunction witn .SLLnP [Sec 


6.3.1] 
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6.3.2 The .RflMn UuO 


CALL: 


• RT1142 AC, 

; return 


After the system has determined real (24 nour system) time, it 
maintains this internally as a number in units of one half second 
since the last midnight. This system call reads into the specified 
accumulator in sixbit characters this time in pairs of digits, 
reading from the left, hours, minutes, and seconds. If tne time has 
not yet Deen determined, minus one will be read. 

6.3.3 The .RDATE UUO 

CALL: .RDATE AC, 

;return 


After the system has determined the calendar date, it maintains 
it internally as a word with six sixbit characters in it. These 
characters are all numeric. The first two are the last two digits of 
the year, the next two are the month number, and tne last two digits 
are the day of the month. This system call reads this word into the 
s.-e^ij.iSu. a^umdlator. If the date nas not yet been determined, 
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minus one will oe read.. In the current implementation, the mate 
being determined implies that tne time [oec 5.3.2] nas been 
determined. The date is correctly incremented every midnight. 

5.4 The MAR Feature 

In order to simulate the address stop facility of the PDP-S in a 
time shared mode, it was decided to introduce a new hardware 
register, the MAR register, to cause interrupts when a particular 
location was addressed by the computer. To increase the flexibility 
of this feature, three control bits were added which further define 
the interrupt condition given that a memory address match has 
occurei. 

Among the system variaDles [App D] kept by ITS for each 
procedure are its MAR register contents and control bits. These are 
loaded into the hardware as the user is started. Since the MAR 
feature is intended primarily as a debugging aid, it causes a class 
two interrupt [Sec 4.2] and a .USET [Sec 5.2.3] is used to set it 
from DDT [Sec ?] more frequently than a procedure sets its own with 
an .SUSET [Sec 4.5], 

•USET and .SUSET take the right naif of the word set from as the 
new address to be put in the MAR register and the low tnree bits of 
the left half as corfrol tits as follows: 
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Bit Meaning (one state). 

3.3 Interrupt if data read or written is negative. 
3.3 Interrupt if data read or written is positive. 
3.1 Interrupt only on a write. 


At tnis time, attempts to differentiate read cycles on tne basis of 
sign will fail as, aue to a timing error, the data always appears 
positive. If a ’write cycle is interrupted on, the protected location 
will have been modified when the interrupt is processed. 

when an MAR interrupt occurs, further MAR interrupts are 
disabled until the MAR is again set. A .SU32T or .USET may be used 
to read the word stored by the JSR at tne system's processor 
interrupt channel location when tne last MAR interrupt occured. 
Although, for their own safety, some parts of executive code inhibit 
MAR interrupts, it is quite possible for the user to cause some 
system calls to interrupt to the user, on reference to his core image 
where his Mar is pointing. The program counter word stored by the 
JSR a t one user s location 43 |_bec 4.3] will be the location in nis 
core image oi tne ollending system call. The word read by a .SHEET 
or .UbET will be an executive program counter word showing the 
absolute location at which the system call first attempted to 
reference tne user's protected location. 
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6.5 The System Job 


There are various tasks ITS would like to perform, most of waicn 

include input-output or waiting indefinite periods of time, whicn 
would he inconvenient to implement directly due to the procedure 
originated orientation of almost all system routines. Because of 
this a procedure was synthesized, known as the system job, that is 
actually a part of the monitor and always runs in executive moue. To 
aid in debugging ITS a feature was added to the system job so that 
when it had no other tasks to perform it would compare constant parts 
of ITS against a copy it makes initially [Sec 6.5.1] . The following 
are some of the other tasks the system job performs: 


(1) Does .CORE's [Sec 4.3.1] for ITS to make room for more blocks of 
user variables or for the system job's copy of constant parts of ITS. 

(2) rrints messages on the system console whenever an effective 

.SETLOC, .GUN, .IOTLSR, .LOGIN, .LOGOUT, or .OPEN for output or .FDELE 
on device SIS is executed. 


(3) Prints messages on the system console when a parity error, 
unrequested change in teletype priority interrupt channel allocation 
memory excessively full condition, or garbage collection of DSN user 
directory* is detected, 

(4) Initially determines the 24 hour time and calendar date [Sec 
6.3.2, 5.3.3]. 

(5) Prints a message on all teletypes when the system is first 
loaded. 


(6) Outputs a 11 CONSOLE ERSE" 
longer open py any procedure. 


message on any teletype wnen it is no 
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(7) Various tasks related to the sytern goin^ down feature [Sec d.5.21 
and TPL device [Sec m.4.5]. 


G.5.1 The .SUPSET UUO 


CALL: 


MOVEI AC,2 
.SUPSET AC, 
;return 


The system job is partially controlled by ITS through a word in 
system memory. Bits to the left of 2.8 in this system 'word represent 
requests for some transient action. In the right half the bottom two 
bits (1.1-1.2) are currently used. Bit 1.1 controls the system 
checking feature. If this bit is on, the system job makes a copy of 
the constant parts of ITS and procedfcs to spend its spare time 
checking the areas it copied against the copy. If a discrepancy 
occurs, a message is printed and the copy corrected. If this bit is 
oif, the system job will destroy any copy it may nave, freeing that 

memory and most of the fraction of the machine time the system job 
uses when in checking mode. 


nit 1.2 affects the TPL device [Sec 3.4.5J. If it is on TPL 


use of the LPT device is 
being printed when this 
will be aborted, and the 
The .SUPSET system 


inhibited, furthermore if a TPL file is 
oit is turned on, it will be deleted, output 
LPT device freed. 

call enables the user to control the system 
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checkin? bit by XOR'ing [Ref l] bits 1.1-2.8 of the specified 
accumulator into the system job control word and returning the 
resulting value in the specified accumulator. It also types out a 
message on the system job console like the message for .SLTLOC. 


6.5.2 The System doing Town feature 


To provide an orderly means for the termination of the operation 
of ITS, a special feature has been added. It is activated by setting 
absolute location S7 negative (either with the PDF—6 console keys 
[Ref 1] or a .SETLCC [Sec 5.8.4]) or using .SHUTDM [Sec 6.5.2.1], 
After a negative location 37 is noticed, all procedures for which it 
is enabled will receive a system going down interrupt [Sec 4.2] and 
all free teletypes have an appropriate message typed on them. Then a 
five minute timer is started and new console trees started [Sec 

1.1.1] will be given a system going down interrupt right after they 
are created. 


'.«hen the timer times out or when the number of console 
controlled trees in which successful .LOGIN's [Sec 6.1] have been 
executed goes to zero, all trees are forceably logged cut ana a 
message typed on all teletypes. All DEC tapes [Sec 3.1.2] for which 
the system is retaining a directory are flapped. 
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6.5.2.1 The .SHTJTD'T UUC 


:ALL: 


MOVE AC, [TIME] 

CITTTrp’n-- a p 
• iiu f 

;error return 
;normal return 


This system call, which is illegal for procedures in a disowned 
tree, is a request for the system to go down [Sec 6.5.E] in as many 
thirtieths of a second as the contents of the specified accumulator. 
If an amount less than five minutes is specified, it will he treated 
as though it had been five minutes. If the system is already going 
down in less time than specified, this call will he ignored and 
return without skipping. 

If the system is going mown in a longer time than specified or 
not going down at all the call will succeed and skip. It will cause 
a system going down interrupt to all enabled procedures and start a 
timer ior the specified length of time, hew console trees created 
thereafter LSec 1.1.l] will also receive a system going down 
interrupt when created. If the time till system death passes through 
five minutes, all enabled procedures will be interrupted again. 

The conditions for and actions on actual death are as in section 

a ^ o 
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5.5.2.2 The .DIETIM UUO 

CALL: .DIETIE AC, 

;return 

This system call sets its specified accumulator to minus one if 
the then running ITS is not going down [Sec C.u.2]. If it is, the 
accumulator is set to the maximum time till system death in 
thirtieths of a second. 

5.6 Examining ITS 

5.6.1 The .C-ETSTS T JU0 


CALL: 


DATLOC: 


MOVE AC , [-LENGTH, ,DATLCC] 
MOVE AC+1,[sixbit /area/] 

.GETSYS AC, 

;error return 
jnormal return 


BLOCK LENGTH 


;area read into 


This sytem call enables 
internal monitor areas in sue 
must consistent. The snec 


- procedure to receive conies 
i a v-ay that the data in those 
.fled accumulator contains a p 


of various 
areas 
ointer 


word as for a block 
accumulator is zero 


mode .IQI [Sec 2.3]. 
the block is treated 




U X 


runninr to 


t.r 


t h C 


p ir e i''. •h' 
h.iU Ui 



the specified 


the users core image. The location following 
accumulator contains, in left justified sixbit, the area requested as 


follows: 


Sixhit Area 

TRAITS Translation table [Sec 2.2.2]. 

GETS List of things which can he requested with .GET5Y3. 

DEVS List of available syrai(i\c)ic input-output devices [App C] , 

MEMORY Memory allocation tables [Sec 4.3]. 

UTAPE DSC tape routine variables [Sec 3.1.2]. 

CLINK Core link variables [Sec 3.4.3]. 

CALLS List of symbols in squoze [Ref 3] for system calls [App 
A] and .SUSET [Sec 4.5] left halves and their values. 

DSYMS Symbol table for ITS. 

IMPX Area input multiplexor cycled into [Sec 2.3.3]. 

OMPX Area output multiplexor cycled from [Sec 5.3.2]. 

USERS User variables for all procedures [App D]. 

USER User variables for particular user specified by UNAME 
and JKAME in locations two and three greater than the specified 
accumulator [App D]. If user not found location containing UNaME 
will be zeroed. 


Interrunts are inhibited to a sufficient extent that the data 
obtained can not be inconsistent due to the area£ modification while 
being transfers! to the user. A successful .GETSYS will skip. One 
that fails, due to non-recognition of its sixbit word or insufficient 
memory srecified by its rointer word, will not skip and in the former 
case the sixbit word will be zeroed. 
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.6.2 The 


, Giii 


TLOC UUO 


MOVE AC,[ABSLOC,,LATL0C] 

CALL: .GETLOC AC, 

:return 

LATLOC: 0 ;contents of ABSLOC stored, nere 


This system call simply transfers the contents of the absolute 
location pointed to by the left half of the specfied accumulator to 
the user's relative location pointed to by the right half. If the 
right half points beyond the users memory bound ne will receive an 
illegal instruction interrupt [Sec 4.2]. 

6.6.3 The .RSTSI UUO 

CALL: .RSTSI AC, 

;return 

ihis sytem call reads into the specified accumulator the sixbit 
representation of the second file name of the symbolic file that was 
assembled to produce the running version of ITS. 
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6.6.4 The .EVAL UUO 


MOVE AC, [SQUOZE sym] 
CALL: .EVAL AC, 

;error return 
;normal return 


The .EVAL system call allows a user to easily look up symbols in 
iii«h core DDT's table of system symools. me '’squoze” code [Ref 3] 
for the symbol should be put in the accumulator specified. If the 
symbol is not found, tne call will return without skipping. If it is 
found its value will be placed in the specified accumulator and tne 
call will skip on returning. 


5.7 The One Proceed Feature 


The Project MAC AI Croup PLP-S has been modified so that tnere 
exists a mode in which it executes one instruction and then traps. 
This mode is properly stored when an interrupt occurs and is restored 


by JRSi 2, [Ref l]. For users it causes a class one interrupt and is 
expected to be used by superior (such as'DDT [Sec 7]) procedures by 
.USE! ing [Sec 5.2.3] the u.9 bit of their inferior's program counter 
word. There is coding in ITS such that all system calls will appear 
to be single instructions using this mode, while in tnis mode a user 
interrupt may be serviced and the users status, including this mode, 
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will be restored by a normal'.DISMISS [Sec d.u.Ej. 

6.8 Miscellaneous 

6.8.1 The .SLEEP UUO 

MUVE AC, [TIME] 

CALL: .SLEEP AC, 

;return eventually 

This system call allows a procedure to stop running, while 
remaining interruptable, by either specifying a length of time to 

i 

remain cuescent or a particular time to wake up. If the specified 
accumulator contains a positive number it is considered the length of 
ti^e, in thirtieths of a second, that the procedure wishes to sleep. 
If the specified accumulator contains a negative number then the 
procedure will sleep until the magnitude of system time (as read by 
.RDilMn [Sec 6.3.l]) is greater than the magnitude of this negative 
number. When a .SLEEP returns, the accumulator specified will be 
zero, but if a program is interrupted out of either type of .SLEEP 
tne accumulator will be se'en to contain tne appropriate negative 


number. 
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6.8.2 The .GET!SYM UUO 


CALL: .SjjKSYii AC, 

;return 

This system call returns in the specified accumulator a valid 
sixbit file—name—like symbol that will be unique among those returned 
by .GEilSYM's for a particular system run. 

6.8.3 The .IOTLSR UUO 


MOVSI AC,400000 ;or 0 to release 
oaLL: • IOxLSK AC, 

jreturn 


Procedures run by ITS in IGT-user mode may execute hardware 
input—output instructions which would otnerwise b^ ineffective and 
trap to the monitor. This system call sets the IOT-user status of the 
procedure executing it from the sign bit of the specified 


accumulator. If this bit is a one the procedure will attempt to 
enter ICT-user mode. If it is not currently in IOT-user mode it will 
enter it and a message will be output by the system job [Sec 6.5]- 
unless the procedure is in a disowned tree in which case it will 
receive an illegal instruction interrupt [Sec 4.2]. If this bit is a 
zero, the procedure will not be in IOT-user mode after the .IOTLSR. 


*Vf" 
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5.8.4 The .Siii'LOC and .lx SET jUO's 

MOVE AO , {DATLOC ,, AbSLOc] 

CALL: .SETLOC AC, 

;return 

DATLOC: ... ;data from here written in Ax-SLOC 

The .SETLOC system call treats the specified accumulator as two 
half word pointers. It takes the contents of the relative user 
location pointed to by the left half and places it in the absolute 
location pointed to by the right half and causes the system job to 
output an appropriate message [Sec 6.5] unless the procedure 
executing it is in a disowned tree in wnicn case tne procedure will 
receive an illegal instruction interrupt [Dec 4.8]. 


MOVE AC , [l)ATELK,,AESLGC] 
CALL: .ItSET AC, 

;error return 
jnormal return 


DATBLK: 


The 
.SETLOC. 
however, 
the first 


TESTWD ;tested against c(ABSLOC) 

SETTLED ;set into AESLOC if test succeeds 

• IE'SET system call is very similar to 
The left half of its accumulator, 
roints to a two word block. It first compares 
of tnese two words against tne specified absolute 
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location. If they are not equal, it returns immeuiateiy 
without shipping. If they are equal, it proceeds as for 
.SETLUC but sets from the second word of the bloci: 
and# ships on returning. 

doing to the extra effort to use .IE5ET is much 
safer if you think there is some chance that the absolute 
location you are setting may be moved by trie core 
allocator. 

5.a.5 The PIASTER UUO 

MOVSI AC,400000 ;or 0 to release 
CALL: .MASTER AC, 

;error return 
;normal return 


ITS has a special feature whereby one procedure can receive 
^referential treatment. It will oe scheduled [dec 4.4] with twice 
the priority of a normal procedure (runnining in competion witn a 
second running job, it would reach an equilibrium where it was using 
twice as much machine time) ana is given preierence in the use of the 
DEC 340 display [Sec 3.4.1], 


To request this status a procedure should execute a .MASTER with 
the 4.9 bit of the specified accumulator a one. It will succeed, and 
the .MASTER will skip, if no procedure has the facility seized or if 



ITS 1.5 Reference Manual 


Pare 15D 


the procedure executing the .MASTER nas control foec S.c.l.l] of 
teletype I'UU (the main console in front of the 34U display). If 
the later case, the facility may be removed from another procedure 
having it. A failing .MASTER returns without skipping. 

The facility may be released oy executing a .MASTER with the 
specified accumulator having bit 4.9 zero. This always snips even if 
the procedure does not have the facility to r.^ease. 

6.8.6 The .REDEF T JU0 


HOVEI AC,SYM5LK 
CALL: .REDEF AC, 

;error return 
jnormal return 

SYMBLK: SQUOZE BITS,sym 

VALUE 


This system call allows the user to define, redefine, and delete 
system symbols from high core DDT's symbol table. It is illegal for 
a procedure in a disowned procedure tree. The accumulator specified 
by it should contain a pointer to a two word block. The first word 
in this block should be the squoze code [Ref 3] for the symbol to 
be effected. The second word is the new value for a define (the 
symbol is not currently in the table) or redefine (tue symbol 
currently is in the table). A delete request is indicated by having 
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all four squoze flag tits (nITS in tne above illustration) on. The 
call shirs if successful. It can fail only on an attempt to define 
new symbol when there is no more room above the time snaring system. 
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7. DDT 


See also section 0.3.1. 


7.1 Introduction 


DDT is a general purpose machine language debugging program that 
has been extensively modified to act as a supervisory procedure in 
ITS. It is automatically loaded by ITS [Sec 1.1.1] when a user 
informs ITS of his presence at an idle teletype. All further 
requests of the system by the user, until he logs out, are by means 
of trapping instructions [Sec 1.2] executed for the user, possibly as 
a result of characters he types in, by DDT or procedures inferior 
[Sec 5.1] to and under the control of DDT. The current binary of DDT 
exists as the file KACTRa" on device SYS [Sec 3.1.3]. Tor 
historic reasons, a top level DDT is known as a HACTRH (pronounced 
hack-tran). 


The initial command structure of DDT provided single character 
debugging commands of limited mnemonicity. This structure was badly 
strained cy the introduction of time-sharing related commands. Then 


a new set of multi-letter commands was introduced. This set was 
expanded with the thought of providing all the most frequently used 
commands tnat did not relate to machine language debugging. Since a 
beginning or transient user mignt v/isn lo use only tnese mnemonic 
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commands, a mode switch was added to IDT. There is a monitor moae 
in which only the multi-letter commands are available Desides a few 


interrupt level commands that are unaffected by mode. In IDT mode 
all of the single character debugging commands are also available. 

Section 7.2 below gives more information on monitor mode and 
describes almost all monitor mode commands. Section 7.5 describes 
the few interrupt mode commands in nACTKT and section 7.4 explains 
how DDT tells the user about error conditions, ihe information in 
these three sections should be more than enough to enable extensive 
use of ITS, Particularly the conversational arid interpretive programs 
available under it (such as TECO, LISP and STRING). 

The remaining section (7.5) gives information on finding out 
about DDT mode commands. These would be important to someone 
developing a machine language program. 


7.1.1 When DDT Starts 


When a new copy of DDT is started, it types out certain useful 
information. If output is to a GE Datanet 760 console, it first 
clears the screen. Then it types out "DDT.xxx.” where xxx is the 
version number of the DDT so that bugs can be correctly matched to 
version. Then, if ITS is in the system going down mode [Sec 5.U.2J , 
a message indicating its remaining life span is output, xinaliy, if 
a file named SYSTEM MAIL” is found on device SYS [nee L.l.oj, it is 
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tvped out. 


7.2 Monitor Mode Commands 


Then in monitor mode [Sec 7.1], LDT indicates its readiness to 
accept a command "by typing out a At this point the user can 

type a series of letters followed by a break character (normally 
space or carriage return). DDT looks up this symbol (or its first 
six letters if longer) in a table of monitor mode commands. A user 
say also type a comment that will be ignored by LDT in or before this 
string by beginning and ending it with an "~$‘ 4 (alt.-mode), ho $"s 
say be embedded in the comment. If the symbol is found, control is 
transferred to a routine associated with it which may perform 
immediate actions or wait for more information to be typed by the 
user. At any time during the typing of a command, tne user can abort 
and start over by typing a rubout. 

If the string (say "llll") after the is not found in LDT 7 s 
command table, it looks for a file called "TS llll" on device SYS 
[Sec 3.1.3]. If not found an error comment [Sec 7.4] to that effect 
is output. If found, an inferior procedure is created, this file 
loaded into the inferior core image, and it.is then started. The 
effect is as though the following [Sec 7.2] were typed 
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: JOB 1111 

:LOAD SYS: TS 1111 
: START 


except that symbols for the program are not loaded into LPT from the 
file and the normal effects of :LOAL on the current file ana device 
names in BDT is absent. 


7.2.1 Logging In and Out 


:ICOIN uname 

This command takes as its argument the "uname" tnat the user 
wishes to log in with [Sec 5.2]. A "?" will be typed out and the 
command will be ineffective if someone is already logged in with.that 
name. Bor ease in accessing his dish files, a user should use a 
consistent UKAME. 


'»d 

j v 1J1 



~-'P r P 


any 


9 


yJ 


RAIL 


At the time the user logs in, BBT looks for a file named "uname 
on device COM [Sec 3.1.3]. If not found, no action is taken by 
If found, BBT types it out, deletes the file "uname OMAll", if 
on device COM, and renames the "uname MAIL" file as "uname 


• T nOn T ’fTi 


This command expunges all of the user's procedures from tne 
system including the user's HACTRM [Sec 5.1]. The teletype the user 



o 


- ct 

d. • V.V 


P.ef 


:e Manual 



was typing or will 
typed out on it by 
file "uname OMAIL 


V, p « r> ^ r* wj o p ^ 

w- W w V. . . ^ — 1. w V* 


the system job 


on device COM a 


a message to tnat effect will be 
[Sec 6.5]. DBT also deletes the 
t this time (where "uname" is tne 


name the user logged in as). 


7.2.2 Inter User Communication 

:MAIL uname string...~C 

This command takes as its first argument tne user name of 
someone who uses ITS and as its second argument a string terminated 
by a " C". The command prefixes the string to the file "uname MAIL*’ 
on device COM [Sec 3.1.3] if such a file exists. If no suen file 
exists, one is created with the string as its contents. This file is 
presented to the specified user when he logs in [Sec 7.2.1]. The 
user can rubout individual characters while typing the string or 
cancel the command by typing enough rubouts. 


:FJC strine...~C 


This command is intended for use in 
software. It is identical to ":MAIL SYS 


reporting bugs in systems 
string...~C“. 


:ST:'D uname string...~C 
This command taxes arguments like 
send the message string supplied to the 


MAIL above but attempts to 
user specified in a direct 
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nan 


ner so that, if he is loured in, his LACTRL v;ill type the stria 


out on his console. Tf he is not lopped in, LDT will tyre out 
"(MAIL)" and perform the actions specified under :MAIL above. 

:GA3 number 

This command enables a user to rap messages that other users may 
attempt to send to him with :SEHL (above). It ta.-ies a numeric 
argument that is bit decoded as per the table below. 


Lit 

1.1 

1.2 

1.3 

1.4 


Source 

Other user's inferiors. 
Other user's HACTRN's. 
Your inferiors. 

Your KACTAL; (yourself). 


If a bit is on it inhibits messages from the source listed. If off, 

messages are not inhibited. The initial state is :GAG 1. 

The current implementation gives one no way to tell if a message 
£ 

sent was gaged by the intended receiver. 

A. 


7.2.3 Inferior Procedures 


:J03 {jname} 

This command may be followed by an optional job name [Sec 5.1j. 
If there is an inferior procedure with this JIIaML it will be selected 
by LACTAM as its current job (possibly attaching a disowned tree 
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[Sec 5.1.2]). Many commanas in LDT affect tne current job only as 
this changes infrequently and one would not want to respecify it with 
each command. If there is no inferior with the specified name, one 
will he created [Sec 5.1.1] and selected as the current job. 

The joh names SiS and PhPlO are special. The first allows the 
user limited access to absolute core. Tne second allows full access 
to the core image of the PDP-10 [Sec 3.4.2.1] to one user. 

If no argument is supplied to :J0^ it attempts to select some 
joh different from the current one and type out "jname$J” to inform 
the user it has selected joh jname' . If tfiere is no current or 
other joh, nothing is typed out. If the current joh is the only 
inferior of nACTPui it will he reselected. If other inferiors exist 
one is selected in such a way that all inferiors are cycled through 
hy successive :J0P ;/ s with no argument. 

:KILL 

This command obliterates [Sec 5.2.1] the current joh and all its 
inxeriors if it is an immediate inferior. If not an immediate 
inferior the variable space for it in HACTKK is reclaimed and logical 
Dointers to it obliterated. In either case a :J03 with no argument 
is then simulated to minimize the time during whicn there is no 
current job. 
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This command lists ail of tne inferiors 
aware. An ' is printed before tne current 
.lot will be a character indicating its state 


of whicn RACTRii is 
job, if any. After each 
as follows: 


Character Status 
- Just created or loaded. 

?. Running. 

P Procedable from random interrupt. 

Bn ProcedaDie from breakpoint n [Sec 7.5]. 

w Interrupt/message to hASTRii pending. 


After this letter is the user index of tne procedure (see section 
8.2, mode H)• An example of :LISTJ output appears in Appendix G. 


This command disowns [Sec 5.2.2J the current job, deselecting 
it, expunging all information about it in HACTRlv,and simulating a 
:JQ3 with no argument. 


:L0AB {file specification] 

This command attempts to load a file into the current job. 
HACTRN has a current device, system name [Sec 2.2.3J, and pair of 
file names which it will use if nothing is specified after a command 
taking a file argument. This current file is initially device DSh, 
file name 4 3IR , and the system name the user logged in as [Sec 
7.2.1], Various fields can appear in the file specification 
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This command, lists ail of tne inferiors of whicn uACfRil is' 
aware. An w is nrin ted before tne current job, if any. After each 
job will be a character indicating its state as follows: 


Character Status 
- Just created or loaded. 

?. Running. 

P Procedable from random interrupt. 

Bn Procedable from breakpoint n [Sec 7.5], 
w Interrupt/message to hACTRli pending. 


After this letter is the user index of tne procedure (see section 
8.2, mode H). An example of :LISTJ output appears in Appendix C. 


: SI SCWII 

This command disowns [Sec 5.2.2J the current job, deselecting 
it, expunging all information about it in RACTRh,and simulating a 
:J03 with no argument. 


:LOAS {file specification} 

Tnis command attempts to load a file inio the current job. 


RACTRW has a current device, system name [Sec 2.2.3J, and pair of 
file names which it will use if nothing is specified after a command 
taking a file argument. This current file is initially device SSk, 
iile name A -Id , and the system name tne user logged in as [Sec 
7.2.1J. Various fields can appear in the file specification 
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distinguished, oy their terminating character. A “dev:" field sets 
ttie device to ^'dev '. An sname; sets the system name to sname . a 
field terminated by a space or carriage return (tne later indicating 
the end of the file specification) is treated differently depending 
on how many of this type of field have been seen, The first, if any, 
such becomes the first file name. The second, if any, becomes the 
second file name. A third, if supplied, becomes the device name (as 
if followed by a ‘V) and indicates the end of the file 
suecification. 


:DUMP {file specification} 

This command dumps the current job as a file optionally 
specified as in :L0AI> aoove. 


:StART {number} 

This command starts tne current job, giving it control of tne 


user's console [Sec 3.2.1.1]. If no argument is supplied it is 
started at the last place it was started witn a :START. If not 
:START'ed before then at the assembled in starting address that was 
read in as the program was loaded. If no starting address was 
supplied a ? is typed out. 

If a numeric argument is supplied, the job is started at the 
specified address which is stored away for future :START's without 


argument. 
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: COHIT:; IUL} 


This restarts the current 
control of the user's console, 
returning to LAGTun with a "~Z 


job if it is stopped and gives it 
It can os used to continue after 
[Sec 1.1.2J. 


This command restarts the current ,iob if it is stopped but 
leaves HACTRii in control of the users console. Using this command 
the user can easily get several inferiors running at the same time 

7.2.4 Piles and Innut-Output 


:PKIHT (file specification} 

This command treats a file as ASCII characters and prints it 
out. It accepts an optional file specification as described under 
:LOAD [Sec 7.2.3} above. 


file 


:DELETE {file specification} 

This command deletes [Sec 2.4] a 
specification as described under 


file. It lanes an optional 


:LUAD [Sec r'.E.h] above. 


:LI3TP {device name} 

This command lists the files on hACfhH's current device 


or 


til 
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device specified as an.argument [Sec 2.2.1]. 

:FLA.P number 

This command must be followed by the number of a PEC tape drive. 
It causes the tape on the specified drive to be physically demounted 
and its directory to be excised from ITS [bee 3.1.2.1J. 

:LI1TK {file name pair} sname; fnaml xnam2 

This command creates a link [Sec 2.1.1.1] under EACTRM's current 
system name to the file “fnarnel fnamb' 1 under system name v 'sname“. 

The link's file name is also "fnaml fnam2“ unless tne optional file 
names shown aDove are supplied. 

7.2.5 The "Control-P** feature 

BET has a feature which is designed to reduce the need to 
repeatedly type the same or very similar file names at different 
systems programs, lor historic reasons this is called a "Control-?*' 
feature. This feature is implemented using a block of four locations 
in DDT. These are deposited in the core image of a newly loaded 
inferior by the execution of certain Ejjt moae [Sec 7.o] commands and 
certain of the commands explained below. The locations set in an 
inferior and their signiiicance are as follows: 
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Location Significance 

DU First file name. 

51 Lew second file name. 

54 Current second file name. 

53 Ola secona file name, 

:CR 

This command reads in a file name as for :LQAD [Sec 7.2.3], It 
puts the first file name read in the DDT word to be deposited in 
location 50. It puts the second file name in the LDT word to be 
deposited in location 52 and the second file name incremented in the 
word to be deposited in location 51. It clears the word to be 
deposited in 53 and finally loads, deposits in 50 through 53, and 
starts a copy of TECO, the normal ITS editing program, as for a :TECO 
[Sec 7.2] except for the deposition*in 50 tnrough 53. 

:ED 

This command increments the file name in the location to be put 
in 51 and then puts the incremented file name bach after moving what 
was there into the location to oe put in 52 and similarly moving that 
word into tne location to be put in 53. It then loads, deposits in, 
and starts a copy of TECO, the normal ITS editor, as for a :TECO [Sec 
7.2] except for the depositions in 50 through 53. 


: ST 


'TV, 


lis command simply reads a file name and does tne same thins 
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with it as :CR (described above) except it does not load or start a 
"ECO. 

7.2.6 Miscellaneous 


• 9 

• • 

This command lists all important monitor mode commands with a 
short explanation of each. An example is shown in Appendix G. 


:I)DT 

This command switches HACTRK to DDT mode [Sec 7.1]. 

sMOlI 

This command switches HACTRK to monitor mode [Sec 7.1]. 


:XEILE (file specification} 

--'-is command reads the file, optionally specified as for :LOAD 
[Sec 7.2.3] above, and, treating it as ASCII, executes it as HACTRK 
commands. 


:SYMLOD {file specification} 

Mostly useful in conjunction with DDT mode 
this command loads symbols only for the current 
optional file specification as for :LOAD [Sec 7 


Lbe^ 7.a] commands, 
Jod. It takes aii 

• wJ d jO V 6 • 
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:ERR 

Mostly useful in conjunction with jjDT mole [Sec 7.5] commands, 
this command interprets the last quantity typed out by HAGTHE as a 
.STATUS [Sec £.5] word using the ERR device [Sec 3.4.4]. 

7.3 Interrupt Level and Context Tree Commands 

There are six single character commands to HACTRN that are 
interpreted at its interrupt level or at its top level in a manner 
independent of and not affecting the context in which they occur. 

They are presented in alphabetic order below. Two provide tne user 
with the ability to "silence" any particular output of nis RACTHE and 
abort it from a hung state. The remaining four control where 
HACTRN's output goes. 


Character Effect 


Attempts to seize the line printer [Sec 3.2.2]. If 
successful, causes HACTRN output to be printed. 

E Releases the line printer [Sec 3.2.2] and stops HACTRN 
output from being printed. 


,n 


ses HA( 

and wait for new commands. 


Interpreted at the the interrupt level, this command 


causes HACTRN to abort from whatever it is doing, type out "QUIT?' 


This command should only be used when 
necessary (ie HACTRN seems to be permanently hung up) as tnere is 
almost no protection from interrupting out of embarrasing places 
where variables are out of nhase, etc. All buffered type in and out 
is also reset [Sec 2.7.2]. 
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~S This chare ter is interpreted at Loth interrupt and top 

level. It inhibits hACTRR output, also doing a type out reset [Sec 
£.7.2] , between tnese^two interpretations. Thus "'V is a much less 
drastic step than G (above) to be used wnen the only trouble is 
that HACTR7 is beinv somewhat Iona winded. It re-enables output wnen 
HACTR’ T vets around to it at the ton level. 

~V Inis command causes HACfRh output to be typed. It is 

the initial state. 

W This command stops SAC rub output from Leins typed. 


7.4 Error Comments 


uLT used to have two error comments, ”u" and "?". Tne first of 
these is typed out when an undefined symbol is evaluated, usually 
when it is terminated by a non-symtol-constituent. The second was 
typed out for all other errors. It has been significantly augmented 
Errors in attempting to open, rename, or delete a file are 
indicated by the comment produced by the ERR device [Sec 3.4.4J 
followed by the symbolic name of the device and a question mark. In 
the case of an input-output error interrupt from an .IGT or .OPER, a 
special check is made to see if tne error is device full on the 
inuut-output channel on which dumps are written. If so, the partial 
dump is deleted and an appropriate message output. Ctnerwise, tne 
following error comment is output. 

r, t' TP VO 

“ »•«»:, -J-Uu f 


where n is the error 


number, m the input-output channel on *hi: 
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it occured, and ~ the location of the offending .ITT or .OPEH. for 
other errors indicated by interrupts the following is output: 


where r. is a number with the interrupt bits on and p is tne 
location interrupted from. 

Other error comment listed in the following table: 


Output Meaning 

- T UL? Interrupt from unknown inferior. 

TMJ? Attempt to have too many inferiors. 
CHS? Checksum error on load. 

ECT? Unexpected end-of-file on read. 

GET? Unable to assign console to inferior. 
COR? Can't get more core. 

JOE? ho current job. 

UEF? EEC tape unflappable. 

USE? Disown failed. 

TMS? Too many undefined symbols. 

ILUUC? Illegal UUO executed in DDT. 

LOGIE? You are not logged in. 


7.5 DDT Mode Commands 


Monitor mode commands may also be used in DDT mode. It 


is 


simply necessary for the user to 
information on DDT mode commands 
are recommended. Also one might 


type the initial : . ior furtner 
references 2, 7, and 3 of this memo 
try next year's edition of this 


memo 
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5.1 Introduction 


PEEK is a utility program operating under ITS. It enables a 
user to monitor a variety of aspects of the tine sharing system by 
providing periodically updated display output or periodic character 
string output to teletype or line printer. Commands to PEEK are 
single letters sometimes preceded by numeric arguments. When 
initially started, PEEK is in II, or normal, mode LSec 8.2]. If the 
user is on a C-E console [Sec 3.2.1] PEEK will initially start 
outputing by tyring (which, on a GE console, is effectively 
displaying). If the user is on a teletype, PEEK will try to seize 

the 340 display [Sec 3.4.and eitner display on tne 340 or type its 

output depending on whether it succeeds or fails, respectively. This 
may be disconcerting if you are at a teletype not in view of the 340 

because it will appear that tne PEEK is just sitting there. Tnis can 

be rectified with the N command [Sec 3.3]. 

The first line of all pages output by PEEK.is as follows: 


ITS xxx . PEEK yyy mm/dd/yy ■ hh:mn:ss 


4here xxx is the version number of the system in use [Sec 6.5.3], yyy 
is the version number of the PEEK in use (so bugs can be maicned to 
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exact version), end mn/dd/yv is the da 
according to ITS [Sec 6.5.2, 5.3.5]. 
errors have occured during the current 
displayed listing the number of each. 


te 

r r< 

» CO c 

- a • in _.i • r 

5 tne time 

If 

any 

core or 

dish parity 

s y 

stem 

run, a 

second line 


Tne last line of all pages 




displayed on the 340 by ?Sun is a list of mode commands which can be 
-i y en by light-penning [Sec 3.4.1.2] them with effects identical to 
typing them. 

All characters typed at PEEK are interpreted at its interrupt 
level and have effect, if any, immediately. Characters that are not 
commands, digits, or ~Z are completely ignored. Digits are 
accumulated as an octal number until a non-digit is typed at which 
time the accumulated number is made available (if the non-digit is a 
command talcing a numeric argument) and reset. 


fine amount of memory occupied by PEEK varies with mode but the 
present minimum is three memory blocks (a total of 6000 words). 


8.2 Modes Available 


The particular subset of the time sharing system's status being 
output by PEEK is controlled by its mode. Initially PEEK is in 1! 
mode but it may be changed .to any of those listed below by typing the 
letter indicated or light penning [aec 3.4.1.2] it if PEEK is 
displaying on the 340. Unless otherwise specified the output 
repetition rate for these modes is the standard rate initially set to 
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5 seconds delay after end of page output refore starting on the next 
update. This is variable by the user with the Z command [Sec 8.4J. 


This mode outputs 
u.ish device [Se 


the A 


5.2.1J for 
list only those files for the 
If the PEEK is running as an 


system supplied directories [Sec 
c 3.1.1]. Ihe directory output will 
system name ^{Sec 2.2.3] of the PEL;,, 
inferior of W1 [Sec 7], tnis system 


name nay be easily changed by a I'D! command. If output is to the 
340 display, the user directory is prec4eded by a list of extant user 
directories which may be individually light penned to change PEEK's 
system names and select a different directory to display. 


G This mode lists the sixbit symbols recognized by .GETSYS 

[Sec 5.6.1] in the system in use. Output is updated after a ten 
second delay. 


e Only available with the 340 display, this mode outputs a 

graph of memory with different memory users [Sec 4.3] on different 
vertical levels and location represented by horizontal coordinate.- 

I The symbolic devices implemented in the system in use 

[App A, I] are listed by this mode. Output is updated after a ten 
second delay. 


4 This mode is somewhat reminiscent of h mode. It lists 

all memory users and the t< amount of memory they are using in 
decreasing order. An is also output by stopped jobs as are tne 

characters for special resources being used by any job (see table 
below). 


/ This is the most frequently used mode of PEEK. It tries 

to give a snapshot of the status of all user jobs in tne system. 
Difierent amounts of information are displayed defending on the 
particular output device in use, but in all’cases'the following 
additional information is output: 


(1) Above the list of user jobs, tne number of free 
blocks (each mOOO words) of memory (MEMEH), tne number of areas that 
are allocated for user variable [App J] (USPHI), and tne number of 
user programs that were runnable last scnedule time (PELAELU); 

(2) lelow the list of user jobs, the number of blocns of 

memory occupied by user urograms (USE MEM) (the sum of this figure 
ana. is not constant due to dynamic 10 buffers), the total 

percentage of machine time being used by the listed programs (USE 
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TIM) (less than one nun d red. 
the amount of time tnat tne 
the total amount of machine 
(LOUTIM). 


aue to scneduling and otner overnead), 
running system has oeen up (ST IMA), and 
time usea by users tnat have logged out 


Between the two seis of information describee above, 
there is one line of information for each procedure in the system 
topped by a title line whicn provides a neading for each column of 
information. The first item on the line for any particular procedure 
will be the user index of the procedure, a number that uniquely 
refers to it (see mode 7). The second item will be eitner*the URAMjo 
for ton level procedures and tne JNAMii for inferiors or the UUAME, 
J'lAME, and 3RAUE for each procedure depending on the line width of 
the output device. This second item also portrays the existant 
procedure tree structure in that each P|6(j/cedure not at the top level 
is an inferior of the nearest procedure above it whose name is not 
indented as far. 

Other items include an exponential approximation to tne 
percentage of machine time the procedure nas been receiving, the 
number m of core blocks it is occupying, a column labeled “TTY* tnat 
nas a T concatenated with the console number opposite procedures 
controlling a console, various letters immediately after the “TT'i“ 
column for system resources controled by the procedure (see the table 
below), and a column labeled STATUS . The character string opposite 
a procedure inutile STATUS column should be interpreted as follows: 

(1) a leading * inaicates that tne procedure is processing a 
soltware interrupt [Sec 4 .a], (A) RUM indicates that the program is 
running in user mode, (5) a pair of numbers separated by an !" 
indicates that the procedure is stopped, (4) most other strings 
represent a system call (with S used for the very common .SLEEP call) 
or u input-output device and type of transfer; (4A) if preceded by a 
+ the procedure is running in executive mode performing the call or 
input-output; (4E) if not it is hung on the call or input-output. 

T The contents of the system translation table LSec 2.2.2] 

is output. 


U ^ This mode displays the status of me DEC tape drives 
[Sec 3.1.2] and of open DnC tape files, ior tne normal user, the 
most useful information per tape is the drive number in the leftmost 
column and the ^TA variable in the next to the rightmost (UTASS) 
column. If tne ml A variable is minus one, ITS is not retaining a 
directory for that drive and a tape mounted on it could be removed 


lanuaily. Otherwise-it is the absolute location of 


-he per open file information includes tne 


the director; 


0 • 


liameS 

using the file, its direction, and the number of buffers (200 words 


-ch) currently being used for the fii; 


of the procedure 
by the syste 
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this .t. ode command snouid ce proceeded oy the user index 
(see .node K above) of some user. It displays many of his user 
variables [App D] and tne channel vora and status ./orl for each of 
Ms input-output channels [Sec 3.1, c.b ]. if output is to the**340 or 
line printer, the contents oi trie selected users accumulators 
also output. 


are 


>- This moae outputs the digitalization of ail tne 

multiplexed analog to digital input channels LSec 3.3.5] and the 
value being output on each of the multiplexed digital to analog 
channels [Sec 3.3.3]. 

X This mode outputs system supplied [Sec 3 . 3 .l] 

directories for EEC tapes. It should be proceeded by a drive number. 


? This mode outputs a list and brief explanation of PEEE's 

commands. An example of its use is included in Appendix G. Output 
is updated after a ten second delay. 


The following are the system resource letters used in modes N 
and M above: 


C Indicates that the procedure is now or was the last to 

use the core allocator. 


^. Ind -icates that the procedure has seized control of the 


F Indicates that the procedure has control of the COE 

device. 


letter can be present for more than one procedure. 
It indicates that the procedure it appears with is in "iOT-user" mode 
[Sec 6.8.3J . 


L Indicates 

printer. 

M Indicates 

G.S.5] facility. 


that the procedure has control of 
that the procedure has seized me 


the line 
.mAoInR [Sec 
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P Indicates that the procedure has control of tne plotter. 

P Indicates that the procedure has control of the paper 

tape reader. 

T Indicates that the procedure has control of the paper 

tape punch. 

10 Indicates that the user has the PDP-1Q core image open 

on device USR [Sec 4.3.2.1]. 


3.3 10 Control 


PEEK will output to only one device at a time. The initial 
device is chosen as explained in section 8.1. All of the following 
four commands for changing PEEK'S output device also cause PEEK to 
immediately restart output for its current mode [Sec 8.2]: 


5 This switches output to the line printer if it is 

available. If not available the output device will be unchanged. 

E This command will terminate PEEK output to ihe line 

printer and cause it to either type or display its output. 

4 This command terminates 340 diplay output, starts typed 

outnut, and sets a flag in PEEK that is cleared only by the ~T 
command. This flag inhibits PEEK'S attempts to seize the 340 as 
described in section 8.1. 

Y PEEK will attempt to seize the 340 display for output on 

receipt of this command. If it is unsuccesful A output will revert to 
typing. In any case the flag mentioned under R above is cleared. 
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3.4 Miscellaneous 


The following are miscellaneous PEEK commands: 


P If the PEEK is running under DDT [Sec 7], this command 

will return control of the users console to DDT but leave PEEK 
running and, if the 340 display or line printer is selected, 
producing output. It uses .VALUE to return the string ’"V as a 
command to DDT. 

Q If the PEEK is running under DDT [Sec 7], this command 

will destroy the PEEK it is typed at and return control_of M the users 
console to DDT. It uses .VALUE to return the string ”£~X." as a 
command to DDT. 

Z This command should be proceeded by a small number. It 

sets the standard update delay to as many seconds [Sec 3.2], 

! This command will probably go away when swapping is 

added to the system. Under normal circumstances it will cause tne 
procedure tree in which is found the PEEK it is typed at to be 
replaced by a single newly loaded PEEK at the top level. This saves 
memory if several people want to leave a PEEK at a single console 
running for their joint enlightenment. A top level PEEK will commit 
suicide if a ~Z is typed at it. 
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9. LOCK 

9.1 Introduction 

LOCK is a utility program operating under ITS performing a 
multitude of infrequently required tasks. Its name derives from tne 
fact that the function it was originally written for was to "lock” 
and "unlock" teletypes (see the + and - commands [Sec 9.2]). Host of 
LOCK's commands are single characters. 

In contrast to PEEK [Sec S] , which interprets commands at tne 
interrupt level, commands to LOCK are read at its main program level. 
Thus commands will in general have no effect "before previous commands 
have keen completed. In fact, some commands cause a change in the 
state of LOCK such that following letters are interpreted as 
arguments. 

LOCK occupies only one clock (2000 words) of memory except after 
the "T" command. 

9.2 Commands 

The following are the current LOCK commands: 
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+ This command should be proceeded by a teletype number 

[Sec 3.2.1] . Tne LOCK v. r ill try to open tne specified teletype as an 
input-outrut device. It will be succesful only if the teletype is 
nothin use. If it is successful, the teletype will become impervious 
to Z s so no user can lor in on it, LOCK will tyre out an 
appropriate message on the now locked teletype, and LOCK will type a 
V, to the LOCX^user. If the LOCK fails in opening the teletype it 
will type an "l" at the LOCK user. 

This command should be proceeded by a teletype number. 

If LOCK has the specified teletype locked (see "+" above) it will 
unlock it and type out an Otherwise it will type a "?". 

_ This command should be preceded by the octal code for a 

characterLOCK will type out the character represented in image mode 
[Sec 3.2.1]. This is useful for determining the reaction of a console 
to various codes. 

C- This command should be preceded by the user index [Sec 

3.2, see mode !!] of the top procedure in a tree that the user wishes 
to obliterate. It must be followed by m the characters "Uif . If tne 
user deviates from this sequence, a "?” will be typed and LOCK will 
listen for a new command. If the user uoes not deviate tne system 
job [Sec 6.5] forceably logs out [Sec 5.4] the tree and types out a 
message on the system job teletype. 

I A series of magic characters must be typed at a model 3? 

teletype to allow its use in full duplex, the mode assumed by most 
programs operating under ITS. This command causes LOCn to type the 
requisite characters in image mode [Sec 3.2.1], 


This command must be immediately followed by the 
characters ILL (see C above) and should be preceded by a number. 
It will activate the system going down feature [Sec 6.5.2] with a 
time limit of five or the number preceeding the command minutes, 
whichever is larger. 


0 Khen it receives this command, LOCK will permanently. go 

into a.mode wherescharacters typed at it are echoed as thar* ASCII 
values in octal. JTo ultimately escape from LOCK in this mode t v e 
user should use ~Z [Sec 1.1.2], 


? If LOCK is running under a mLT [Sec 7], this command 
causes control of a user§ console to revert to it. Tu- ccm~ ,E,r id u 
.VALUE to return a null strins. 


id uses 


If LOCK is running und 


-Dr L Sec 7j, this comm 



causes control of a user% console to revert to r.is LOT met his ICCn 
to he 'destroyed, "ote that this ..ill unlock all teletypes previously 
locked (see + above) by the destroyed LOCK as destroying a 
procedure closes all its channels. It uses .VAL jL to return the 
s triny ":KILL . 

S This command complements the run status of the system 

checking feature of the system iob [Sec C.5.1], It will type out tne 
resultant state as either "START" or "STO?". 

T This command causes complex and nonterminatinp cyrat ions 

on the part of the LOCK it is typed at and the procedures the LOCK 
will create as a result of this command. Its purpose is to test the 
core allocator [Sec 4.3] and other components of tne ITS system. Its 
casual use is not recommended. 

? This command causes LOCK to type out an up to date list 

of its commands with a brief explanation of each. An example appears 
in Appendix C. 
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Appendix 

A. System Calls in ’Tumeric Order 
(correct as of ITS version OPS) 


Uame 

■'umber 

Section 

• IOT 

UuO 040 

2.3 

.CPEE 

UUO 041 

2.2 

.OPER 

uUG 042 

1 . 2.1 

. ITYI 

.OPER 1 

App E 

.LISTS 

.OPER 2 

3.2.1.2 

.SLEEP 

.OPER 3 

6.3.1 

.SETMS 

.OPER 4 

App E 

.SETM2 

.OPER 5 

4.2.1 

.LOGIN 

.OPER 5 

6.1 

.CLOSE 

.OPER 7 

2.7.1 

•UCLOS 

.OPER 10 

5.2.1 

.ATTY 

.CPER 11 

3.2.1.1 

•DTTY 

.OPER 12 

O . 3 . 1 . 1 

.IOPUS 

.OPER 13 

2 . 6.1 

.ICPO? 

.OPER 14 

c, . o. 1 

.DCLCS 

.OPER 15 

3.4.1.3 

.ESTOP 

.OPER 16 

^ ' .4.1.4 

»— i 

C-H 

r\~* 

‘ —4 

• 

.OPER 17 

6.3.1 

.RLSl'T 

. OPER cO 

6 . 2.1 

n 7 T 7 t 
• ’jUiM. 

.OPER 21 

5.4 

.ULISN 

.OPER 22 

^. 1 . 2.1 

.GETSY 

.OPER 23 

6 . 6.1 

.RD5G0 

.OPER 24 

6.2.4 

•uETLO 

.OPER 25 

6 . 6.2 

.SETLO 

.OPER 26 

6.3.4 

.DISOW 

.OPER 27 

5.2.2 

.RD750 

.OPER 30 

6 . 2.2 

.Wn750 

.OPER 31 

6 . 2.2 

.GidlSY 

.OPER 32 

6.3.2 

.LOGOU 

.OPER 33 

6.1 

.GSNA.4 

.OPER 34 

App E 

• W SMm 

.OPER 35 

App E 

•UPISE 

.OPER 36 

App E 

.RESET 

.OPER 37 

2.7.3 

. ARMGY 

.OPER 40 

r Z *7 p 1 

* • o • c*, % x 

.WMAR 

.OPER 41 

App E 

•RRTIM 

.OPER 42 

App E 

• A n S I or 

.OPER 43 

o • X • 3 • cL 

.DESIG 

.OPER 44 

C* * d 

.RTIEE 

.OPER 45 

- - ^ ? 

.RDATE 

.OPER 46 

q.3.3 
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.OPEL v/ 

5.2.3 

.EUFC 

. OPiA 5u 

3.5.1 

. IOTLS 

.OPER 51 

o.d.3 

.RSYSI 

.OPER 35 

6.6.3 

.SjPSE 

.OPER 55 

o.5.1 

. UoLAl 

.OPER 5o 

3.1.2.3 

. I0PPL 

.OPER 5? 

3.6 .-2 

.MIC 

.OPER 60 

2.7.3 

. MAS IE 

.OPER 61 

6.3.5 

•YSTST 

.OPER 62 

3.3.1.1 

.DIAL 

.OPER 63 

3 . 2 . 1 . 3 

.DIAL VI 

.OPER 64 

3.2.1.3 

• HAAa U 

•OPER 65 

3.2.1.3 

•DISTI 

.OPER 66 

C. 5 • 5. 2 

. SHUTD 

.OPER 67 

6.5.2.1 

•ARMOP 

.OPER 70 

3.5.2.1 

• LID IS 

.OPER 71 

o . 4 • 1 • 5 

.FLED 

.OPER 73 

3.2.4.1 

.EVAL 

•OPER 73 

5.6.4 

. REDEF 

.OPER 74 

6.6.6 

.IESET 

.OPER 75 

6.8.4 

.UTIIAM 

.OPER 76 

3.1.2.4 

.UIUIT 

.OPER 77 

3.1.2.5 

. CALL 

UUO 043 

1.2.1 

.LISMI 

.CALL 1, 

4.2.2 

•TEAMS 

.CALL 2, 

2.2.2.1 

. TEAR A 

. CaLL 3 , 

5.2 #2.2 

.VALUE 

.CALL 4, 

5.3.1 

• UTitAA 

. CAL'Jj 3 , 

5.1.3 

.CORE 

.CALL 5, 

4.3.1 

.TRIED 

.CALL 7, 

2.2.2.3 

.DSTAR 

.CALL 10, 

3.4.1.1 

. FDELE 

.CALL 11, 

5.4 

•DSTRT 

.CALL 13, 

3.4.1.1 

.SUSET 

.CALL 15, 

4.5 

•LTPEU 

.CALL 14, 

3.4.1.2 

.VSCAN 

.CALL 13, 

3.3.1.1 

.POTSL 

.CALL 16, - 

•7 T r Z. 1 

m ^ • -L 

• USET 

UUO 044 

5.2.3 

.EEEAE 

UUO 045 

c 'Z y 

•STAxU 

UUO 046 

5.5 

. Ac C jjki 

UUO 047 

2.7.4 



1X5 1.5 Reference -ianual 


Page lo*i 


Appendix 

n. System Calls in Alphabetic Order 
(correct as of ITS version o28) 


Lame 

Lumber 

Section 

.ACCiiS 

UUO 047 

2.7.4 

.AR40I 

.OPEL 70 

3.3.2.1 

•ArtMOV 

• OPEL. 40 

*7 "7 p 1 

• cJ • 

.assig 

.OPER 43 

3.1.2.2 

.ATTY 

.ODER 11 

3.2.1.1 

. EREAK 

UUO U43 

^.5.2 

.CALL 

UUO C43 

1.2.1 

•CLOSE 

.OPER 7 

6.7.1 

.CORE 

.CALL 5, 

4.5.1 

.DCLOS 

.OPER 10 

6 . 4 • 1»o 

.RESIS 

.OPER 44 

3.1.2.2 

.DIAL 

.OPER 53 

6 . 2 . 1 . o 

.DIALW 

.OPER 54 

3.2.1.3 

.DIETI 

•OPER ob 

6.5.2.2 

.El SMI 

.CALL 1, 

4.2.2 

•DISOw 

. OPnR xY 

o . 2 . 2 

.DSTAR 

.Call io, 

3.4.1.1 

•ESTOP 

.OPER 16 

3.4.1.4 

.PSTRT 

.CALL 12, 

3.4.1.1 

•DTTY 

• OPER 16 

3.2.1.1 

.EG EC 

.OPER 50 

6.^.1 

.EVAL 

.OPER 76 

6.5.4 

.EDELE 

.CALL 11, 

2.4 

. 1EED 

.OPER 72 

3.2.4.1 

• GJ&SY 

.OPER 32 

6.3.2 

• Gxj iLO 

.OPEL 65 

6.6.2 

.Guts i 

.OPER 25 

6.6.1 

.GrSMAii 

.OPER 3A 

App E 

.GUN 

.OPER El 

5.4 

• fIAIi.aU 

.OPER 55 

V 1 s 

. IESET 

.OPER 75 

5.3.4 

.ICPDL 

.OPER 57 

2.6.2 

.IOPOP 

.OPER 14 

2.6.1 

.IOPUS 

. OPEit 15 

2.o.l 

.TOT 

UUO 040 

2.3 

.IOTLS 

.OPER 51 

6.3.3 

. ITYI 

.OPER 1 

App E 

.ITY1C 

.OPER 5U 

2.7.5 

.LISi'E 

.OPER 2 

3.6.1.x 

.LOGIN 

.OPEn o 

6.1 

.LOGOS 

Hpo?-) ot'a 

• t 1 1 L uu 

c . 1 
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.ltpem 

.CALL 14, 

3.4.1.A 

.MAST! 

.OPEn 61 

0.8.3 

. Mill S 

.OPER 71 

3.4.1.3 

. OPE.'-i 

UUC 041 

2.5 

.OPER 

UUO 042 

1.2.1 

.POTS! 

.Call is, 

3.3.3.1 

.RD5U0 

.OPER £4 

5.2 .4 

.RD710 

.OPER 47 

6.2.3 

.RD760 

.OPER 50 

5.2.2 

.RDATE 

.OPER 46 

6.3.3 

• RDSW 

•OPER 20 

6.2.1 

•RDTIM 

.OPER 17 

6.3.1 

.REDEF 

.OPER 74 

6.8.6 

.RESET 

.OPER 37 

2.7.3 

•RP.TIM 

.OPER 42 

App E 

•RSYSI 

.OPER 52 

5.6.3 

.PTIME 

.OPER 45 

6.3.2 

. SETLO 

.OPER 26 

6.8.4 

.SETM2 

.OPER 5 

4.2.1 

.SETHS 

.OPER 4 

App E 

.SHUTD 

.OPER 67 

6.5. cL . 1 

.SLEEP 

.OPER 3 

6.8.1 

.STATU 

UUO 046 

2.5 

.SUPSE 

.OPER 53 

5.5.1 

.SUSET 

.CALL 13, 

4.5 

nrr\ t \- f 
• llUliiil 

.CALL 3, 

2.2.2.2 

.TRAND 

.CALL 7, 

2.2.2.3 

.TRAPS 

.CALL 2, 

2.2.2.1 

.UELAT 

.OPER 56 

O . 1 . c, . 3 

.UCLOS 

.OPER 10 

5.2.1 

.UDISM 

.OPER 22 

C . 1. (L . 1 

•UINIT 

.OPER 77 

3.1.2.5 

•UPISE 

.OPER 36 

App E 

.USET 

UUO 044 

5.2.3 

.UTMAM 

.OPER 76 

3.1.2.4 

.UTRAN 

.CALL 5, 

5.1.3 

.VALUE 

.CALL 4, 

5.3.1 

.VSCAM 

.CALL 15, 

<^•0.1.1 

.VSTST 

.OPER 62 

3.3.1.1 

.UMAR 

.OPER 41 

App E 

•WR750 

.OPER 31 

6.2.2 

.USRAM 

.OPER 35 

App E 
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Appendix 

C. Available Symbolic Devices in Alphabetic Order 
(correct as of ITS version 553) 


Device 

Type 

Section 

CLA 

CA 

kJ 

c-» • 4: • O 

CLI 

r ~Z 

%J 

«*> • *± • 3 

CLO 

7 

X 4 ^ 

CLU 

7 

r Z .4 "7 

COD 

5 

" P ^ 

CCi-'i 

7 

2.1.3 

DIS 

2 

3.4.1 

DKn 

7 

3.1.1 

DSK 

7 

3.1.1 

T*T> Tv 

ijiin 

4 

3.4.4 

IDS 

2 

3.4.1 

I MX 

4 

3.3.3 

LPT 

2 

3.2.2 

LTLTL 

6 

3.4.6 

I'VD 

D 

3.3.1 

OMX 

? 

3.3.2 

PLT 

2 

2.2.3 

Pnm 

7 

3.1.1 

PTP 

2 

2.2.4 

PTR 

4 

3.2.4 

SYS 

7 

3.1.3 

Tnm 


3.2.1 

TPL 

7 

3.4.5 

TTY 

» — ' 

“ ? i 

T7C 

5 

*7 *7) 1 

• V-> • -L 

IT SR 

6 

3.4.2 

UTn 

7 

3.1.2 

YID 

o 

3.3.1 
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Appendix 

I). System variables ^er User 
(correct as of ITS version 528) 


ICCEHM: 

etc. 

SIOCHU: 
SIOCP: 
IOCHST: 
ICCHHM 


REPEAT 20,0 ;input-output channel assignment words 

;right half, index into IGETS, CLSTE, 

;1eft naif, device dependent 
ELOCK LUIOP ;input-output channel push down list 
3I0CEK-1 ;pointer into input-output push down list 
BLOCK 20 ;input-output channel status for cnannels at 


UPC: 

UPR: 

MEMTOP: 

EMEMT: 

COHRQ: 


0 

0 

0 

0 

-1 


requested for 


request 


AC OS: 
AC15S: 
AC15S: 
AC17S: 


BLOCK 

0 

0 

0 


;3.1-4.9 input-output status 
;1.1-2.9 .ACCESS pointer 

;stores program counter when not running 

;user protection and relocation registers 

5 six less than first illegal location 

jfirst illegal location 

jrequest to core job 

;1.1-1.3 number of blocks, 3.1-4.8 user 

j=« 9 = C means request present, 4.9=1 means no 


15 ;swap out accumulators 

;commonly referenced swap out accumulator 


UUG: 


SUEXIT: 
SUUOK: 
SAC17P: 


;the following three locations swapped in 2 out of 
;UnXIT, HUGE, etc with user 
JP.ST 2,@UU0H ;user UUO exit instruction 
0 __ _ ;contents of 941 (absolute) 

aOVEM U, 5 accumulator 17 in user s shadow memory 


SV4G: 


S 

KS 


V 60: 


0 ;last interrupting UUO 

;(contents of 40 when user cut) 
0 ;contents of £0 when user out 


AC14P: 0 
AC15P: C 
AC15?: 0 
40P: 0 
41P: 0 


t0 accumulator 14 in shadow memory 
15 

15 

points to >( user's relative location 40 
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ic 


APR 


O * 

v.> • 


UST 




APRCKK 


right half is cono 10 processor 

4.9 implies user is in a disowned iree 

4.8 implies user being .UCLCC'ed 

4.7 user has been cored zero 

4.G core request pending on this user 

4.1-4.4 number of last channel on which an 

;error occured 


0 ;stop word ;zero implies runnable 

;4.9 stopped to be moved by core allocator 
;<4.8 general core allocator stop bit 
;4.7 controlled by superior procedure 
;4.6 special bit, see UAMEMT a; UmEMEX 
;1.1-2.9 count of transient reasons to be 

;stopped 


PIRQC: 0 
4SKST: 0 
IIPIR: 0 


UTi 


MPT2 


v. 


JUii • 


0 

0 


pending first word interrupts 
interrupt enable mask for PIRQC 
second word of interupt requests 
3.8-3.1 inferior procedure interrupts 
2.7-1.1 input-output channel interrupts 
1.1 for channel 1, etc 
second word interrupt enable mask 
interrupt level status flag 


SUPPRO: 0 


jpointer and interrupt bit to superior procedure 
;-l for top level procedure 


ELSIKS: 0 
UFIPAX: 0 
RPCL: 0 


;blocking condition instruction 

;zero implies runnable 

jnonzero implies finalization required to 

;interrupt 

;0 implies no RPCLosering in progress 

;0 f ,n RPLSR'ing user n 

;-l,,n being RPCLSR'ed by user n 


UKAME: 0 ;user name 

;This word for each procedure is copied from the URAME 
;of the Procedure that creates it (see USR device). 

;Eor an initial top level procedure it is -1 but is 

■; modified by .LOG-IK. It is the same for all procedures 
;in a tree. 


JPA.Mii.: 0 5 job name 

;Each logged in procedure has a -unique URAME 


;The JKAMn of an initial top level job is riACTRh 
;jobs it is the second file name specified in the 


f jiiApiiij pair • 


. GPu,! 


For other 
on the 
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;U3R device that creates then?.. 


U5YSTJM: 0 :current system name 

;This variable is initially set equal to the procedure's URnt-in. 
jit can be read or set by the procedure or its superior (.SUSlT 

;.USE!). 

jIt is used as the third file name on certain snared devices. 

IJSYSp1: C ;system name used inside dish routines 

;this variable is normally equal to USYSMM but see devices COM old 

;and TPL. 


i 


TYTBL: 


0 


;console assignment for this procedure 


UQUATT: 0 
UTEVTM: 0 
UTMPTR: 0 
JTMU: 0 


;auanturn time 
;total run time 

;pointer to procedure tree resource word 
;procedure resource word 


IOTLSR: 0 


UMARPC: 0 
VALUE: 0 
UCUT: 0 


;4.9 a one implies iot-user mode 

;4.i>-4.3 MAR conditions 

;2.9-1.1 contents of MAR register 

;program counter at last MAR interrupt 

jcontents of effective address of last .VALUE 

;4.S=1 => user not completely in core 

;4.S in transit in 

;4.7 in transit out 

;4.6 ref to disk in progress 

;*x.5 back in core but needs to be blessed before 

;star ting 

>1•1—1•9 core blocns needed for swap in 


USRPDL: 
UPPL: 
EPDL1: 
EPDL: 
2PDL2: 


P-'UPIPIj, f UPDL—1 ;push down list pointer for system calls 
nLOCK LUPPL-2 ;push down list area for system calls 
0 ;link depth for 2311 routines 

0 ; temporarily saves accumulator B for ACORJs. 

0 ;temporarily saves accumulator T for PL5IN5 
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Appendix 

E. Relics of ITS's Vast 


The 

version 
re ami dan 


following system calls, while still effective as of ITS 
5a5, can be expected to ultimately disappear, ihey are 
t *. more specialized, older versions of their replacement 


-lame Number Replaces 

. ITYI .OPER 1 . ITYIC 

open TTY device, if any. 


SETMS 

.OPER 

A 

Rt • 

SUSET 

GSMAM’ 

. OPER 

54 

.SUSET 

VJSNAM 

.OPER 

35 

.SUSET 

UPISE 

.OPER 

35 

.SUSET 

WMAR 

.OPER 

41 

.SUSET 

RRTIM 

.OPER 

42 

.SUSET 


eut iauction 

Read interrupt level characters 

Set own user variable .-ISAST. 
.lead own user variable USYaUh. 
Set own user variable USYSiiM. 
Set own user variable PICLR. 

Set own user variable IGTLSR. 
Read own user variable UTRRTE. 


from 
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Appendix 

X. Further Sources of Information on iiS 


Information further than or more recent than that 
this manual may usually be obtained by consulting tne 
listings of ITS, DDT, PEEK, or LOCK. The following pe 


contained in 
t>y si colic 
rsons may also 


be helpful: 


Donald E. Eastland III 
Jerry S. Freiberg 
Richard D. G-reenblatt 
Thomas F. Knight 
John T. Kolloway 
Stewart 3. Kelson 


Frederick 


C-. Wright II 
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Appendix S. Illustrative Console Output 


The following ra^es are a sample console session 


illustrating several features 


documented, in this memo 
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tZ 

DDT.IPS. 
:LOGIN de 
sPEEK! 



ITS 530 PEEK 142 
PARITY ERRORS: DISK = 


MEMFR=2$7 

U5RHI=11 


1 = 

U-J NAME 

STATUS 

TTY 

0 

SYS 

TYO 

T 5 

1 

CORE 

UUO 

? 

2 

D^ 

s 

> 

3 

PEEK 

+GETSY 

T 4 


10 MS 


07/14/S9 0£:22: 1 $ 


1 1 

CORE : 


RNA3LU 

CORE 

7 TIM 

25 

07 

0 

17 

/■» 

37 

5 

3 7 


USR MEM 
STIME = 


EOAMIC 
SO USR 
7:03:22 


RUM DISOWN 20 917 
TIM= 977 
LOUTIM = 0 


ITS 530 PEEK 142 07/14/S9 00*?2*5P 

MODE CONTROL: “ 

D DISK DIRECTORY 
3 AVAILABLE .GETSYS’S 
H MEMORY GRAPH (340 ONLY) 

I AVAILABLE 10 DEVICES 
M MEMORY USE LIST 
N NORMAL MODE 
T TRANSLATION ENTRIES 
U DEC TAPE STATUS 

V SINGLE USER (PRECEDE BY INDEX) 

X MULTIPLEXORS MODE 

Y DEC TAPE DIRECTORY (PRECEDE 3v #) 

? EXPLANATION MODE 

10 CONTROL: 

tB USE LINE PRINTER 
Tl STOP USING LINE PRINTER 
TY USE 340 
TN STOP USING 340 
OTHER: 

P PROCEED BUT RETURN TTY TO DDT 
Q QUIT 

Z SET DOZE IN SECONDS 
! .STAND ALONE 


Q 

St X. 
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LOCK.39 


«-? 


+ LOCK TTY (PRECEDE BY n 

- UNLOCK TTY (") 

- OUTPUT CHARACTER WITH ASCII VALUE P (") 
GUN KILL USER WITH if INDEX (") 

I INITIALIZE A MODEL 37 TTY 
KILL SYSTEM DOWN IN P MINUTES (") 

0 OUTPUT CHARACTERS IN OCTAL 
P RETURN TO DDT 
Q VALRET AN StX. 

S COMPLEMENT RUN STATUS OF SYS JOS 
T TEST CORE ALLOCATOR 
? LIST COMMANDS 


Stx. 

: ? 


? r LIST MOST COMMANDS 

DISOWN = DISOWN CURRENT JOB 

LOGOUT = AUTO-EXPUNGE 

SYMLOD = LOAD SYMBOLS ONLY 

XfILE r EXECUTE FILE AS DDT COMMANDS 

CR r ENTER TECO AND CREATE FILE 

ED = ENTER TECO AND EDIT 

LOAD = LOAD FROM FOLLOWING FILE INTO CURRENT JOS 
DUMP = DUMP INTO " - FROM ” " 

KILL = KILL CURRENT JOB 

LOGIN z LOGIN AS FOLLOWING NAME 

SEND = SEND MESSAGE 

GAG = CONTROL RECEIPT OF MESSAGES 

BUG = DOCUMENT BUG 


MAIL = ADD TO USER’S MAIL FILE 
JOS = CREATE OR SELECT JOB 
LISTJ = LIST JOBS 

FLAP = FLAP DECTAPE, FOLLOW 3V DRIVE 

LISIF = LIST FILES 

DELETE r DELETE FILE 

PRINT 3 PRINT FILE 

LINK 3 CREATE LINK 

ERR = IOC ERROR STATUS 


P 


DDT 3 ENTER DDT MODE 

MON 3 ENTER MONITOR MODE 

START 3 START INFERIOR 

CONTIN 3 CONTINUE GIVING INE. TT W 

PEGGED 3 PEOCEDE INF., LEAVE TT V WITH DDT 

WALLP 3 tS TO SPECIFIED FILE *.. 
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: LOGOUT 

ITS 530 CONSOLE A FREE. 00:25:57 


l 





